history
Verwenden Sie die history-API, um mit dem Browserverlauf zu interagieren.
Wenn Sie Informationen über den Browserverlauf der Sitzung suchen, lesen Sie die History-Schnittstelle.
Hinweis:
Downloads werden als HistoryItem-Objekte behandelt. Daher werden Ereignisse wie history.onVisited für Downloads ausgelöst.
Der Browserverlauf ist ein chronologischer Verlauf der Seiten, die der Benutzer besucht hat. Die history-API ermöglicht es Ihnen:
- nach Seiten, die im Browserverlauf erscheinen, zu suchen
- einzelne Seiten aus dem Browserverlauf zu entfernen
- Seiten zum Browserverlauf hinzuzufügen
- alle Seiten aus dem Browserverlauf zu entfernen.
Allerdings kann der Benutzer eine einzelne Seite mehrmals besucht haben, daher hat die API auch das Konzept der "Besuche". So können Sie mit dieser API auch:
- die komplette Reihe von Besuchen abrufen, die der Benutzer zu einer bestimmten Seite gemacht hat
- Besuche auf irgendeiner Seite während eines bestimmten Zeitraums entfernen.
Um diese API zu verwenden, 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 zu einer bestimmten Seite im Browserverlauf.
history.VisitItem-
Beschreibt einen einzelnen Besuch auf einer Seite.
Funktionen
history.search()-
Sucht im Browserverlauf nach
history.HistoryItem-Objekten, die den gegebenen Kriterien entsprechen. history.getVisits()-
Ruft Informationen über Besuche zu einer bestimmten Seite ab.
history.addUrl()-
Fügt einen Eintrag zum Browserverlauf eines Besuchs der gegebenen Seite hinzu.
history.deleteUrl()-
Entfernt alle Besuche zur gegebenen URL aus dem Browserverlauf.
history.deleteRange()-
Entfernt alle Besuche auf 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 aufgezeichnet wird.
history.onVisited-
Wird jedes Mal ausgelöst, wenn der Benutzer eine Seite besucht, und stellt die
history.HistoryItem-Daten für diese Seite bereit. history.onVisitRemoved-
Wird ausgelöst, wenn eine URL vollständig aus dem Browserverlauf entfernt wird.
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.history-API von Chromium. Diese Dokumentation stammt aus history.json im Chromium-Code.