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:

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:

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.HistoryItem Objekten, 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.HistoryItem Daten für diese Seite bereit.

history.onVisitRemoved

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
history
HistoryItem
HistoryItem.typedCount
TransitionType
VisitItem
addUrl
addUrl.title
addUrl.transition
addUrl.visitTime
deleteAll
deleteRange
deleteUrl
getVisits
onTitleChanged
onTitleChanged.id
onVisitRemoved
onVisited
search

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Beispielerweiterungen

Hinweis: Diese API basiert auf der chrome.history API von Chromium. Diese Dokumentation stammt aus history.json im Chromium-Code.