history
Verwenden Sie die history API, um mit dem Browserverlauf zu interagieren.
Wenn Sie nach Informationen über den Sitzungsverlauf des Browsers suchen, siehe die History-Schnittstelle.
Hinweis:
Downloads werden als HistoryItem Objekte behandelt. Daher werden Ereignisse wie history.onVisited auch für Downloads ausgelöst.
Der Browserverlauf ist ein chronologisches Verzeichnis der Seiten, die der Benutzer besucht hat. Die history API ermöglicht es Ihnen:
- nach Seiten zu suchen, die im Browserverlauf erscheinen
- einzelne Seiten aus dem Browserverlauf zu entfernen
- Seiten zum Browserverlauf hinzuzufügen
- alle Seiten aus dem Browserverlauf zu entfernen.
Der Benutzer könnte jedoch eine einzelne Seite mehrmals besucht haben, daher hat die API auch das Konzept der "Besuche". So können Sie diese API auch verwenden, um:
- den vollständigen Satz von Besuchen zu einem bestimmten Seite abzurufen
- Besuche für alle Seiten, die während eines bestimmten Zeitraums gemacht wurden, zu entfernen.
Um diese API zu nutzen, muss eine Erweiterung die "history" Berechtigung in ihrer manifest.json Datei anfordern.
Typen
history.TransitionType-
Beschreibt, wie der Browser zu einer bestimmten Seite navigierte.
history.HistoryItem-
Bietet Informationen über eine bestimmte Seite im Browserverlauf.
history.VisitItem-
Beschreibt einen einzelnen Besuch einer Seite.
Funktionen
history.search()-
Durchsucht den Browserverlauf nach
history.HistoryItemObjekten, die den angegebenen Kriterien entsprechen. history.getVisits()-
Ruft Informationen über Besuche einer bestimmten Seite ab.
history.addUrl()-
Fügt einen Eintrag im Browserverlauf für einen Besuch der angegebenen Seite hinzu.
history.deleteUrl()-
Entfernt alle Besuche der angegebenen URL aus dem Browserverlauf.
history.deleteRange()-
Entfernt alle Besuche von Seiten, die der Benutzer während des angegebenen Zeitraums gemacht hat.
history.deleteAll()-
Entfernt alle Besuche aus dem Browserverlauf.
Ereignisse
history.onTitleChanged-
Wird ausgelöst, wenn der Titel einer vom Benutzer besuchten Seite protokolliert wird.
history.onVisited-
Wird jedes Mal ausgelöst, wenn der Benutzer eine Seite besucht, und stellt die
history.HistoryItemDaten für diese Seite bereit. history.onVisitRemoved-
Wird ausgelöst, wenn eine URL vollständig aus dem Browserverlauf entfernt wird.
Browser-Kompatibilität
BCD tables only load in the browser
Beispielerweiterungen
Hinweis:
Diese API basiert auf der chrome.history API von Chromium. Diese Dokumentation stammt aus history.json im Chromium-Code.