Verwenden Sie diehistory-API, um mit dem Browserverlauf zu interagieren.

Wenn Sie Informationen über den Browserverlauf der Sitzung suchen, lesen Sie dieHistory-Schnittstelle.

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 ihrermanifest.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 nachhistory.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 diehistory.HistoryItem-Daten für diese Seite bereit.

history.onVisitRemoved

Wird ausgelöst, wenn eine URL vollständig aus dem Browserverlauf entfernt wird.

Beispielerweiterungen

• history-deleter

Browser-Kompatibilität