Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Utilisez l'API historique pour interargir avec l'historique du navigateur.

Notez que les téléchargements sont traités comme des objets HistoryItem. Par conséquent, des événements tels que history.onVisited seront également déclenchés pour les téléchargements.

L'historique du navigateur est un enregistrement chronologique des pages que l'utilisateur a visitées. l'API d'historique vous permet de :

Cependant, l'utilisateur peut avoir visité une seule page, plusieurs fois, de sorte que l'API a également le concept de"visites". Vous pouvez également utiliser cette API pour :

Pour utiliser cette API, une extension doit demander la permission "history" dans le fichier  manifest.json.

Types

history.TransitionType
Describes how the browser navigated to a particular page.
history.HistoryItem

Provides information about a particular page in the browser history.

history.VisitItem

Describes a single visit to a page.

Fonctions

history.search()
Searches the browser history for history.HistoryItem objects matching the given criteria.
history.getVisits()
Retrieves information about visits to a given page.
history.addUrl()
Adds a record to the browser history of a visit to the given page.
history.deleteUrl()
Removes all visits to the given URL from the browser history.
history.deleteRange()
Removes all visits to pages that the user made during the given time range.
history.deleteAll()
Removes all visits from the browser history.

Evénements

history.onTitleChanged
Fired when the title of a page visited by the user is recorded.
history.onVisited
Fired each time the user visits a page, providing the history.HistoryItem data for that page.
history.onVisitRemoved

Fired when a URL is removed completely from the browser history.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
HistoryItem Oui Non49 * Non Oui
TransitionType Oui Non50 Non Oui
VisitItem Oui Non50 Non Oui
addUrl Oui * Non49 Non Oui *
deleteAll Oui Non49 Non Oui
deleteRange Oui Non49 Non Oui
deleteUrl Oui Non49 Non Oui
getVisits Oui Non50 Non Oui
onTitleChanged Non Non55 Non Non
onVisitRemoved Oui Non50 Non Oui
onVisited Oui Non50 * Non Oui
search Oui Non49 Non Oui

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.history. Cette documentation est dérivée de history.json dans le code de Chromium.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,