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
Décrit comment le navigateur a navigué vers une page particulière.
history.HistoryItem

Fournit des informations sur une page particulière dans l'historique du navigateur.

history.VisitItem

Décrit une seule visite sur une page.

Fonctions

history.search()
Recherche dans l'historique du navigateur les objets history.HistoryItem correspondant aux critères donnés.
history.getVisits()
Récupère des informations sur les visites sur une page donnée.
history.addUrl()
Ajoute un enregistrement à l'historique du navigateur d'une visite sur la page donnée.
history.deleteUrl()
Supprime toutes les visites à l'URL donnée de l'historique du navigateur.
history.deleteRange()
Supprime toutes les visites aux pages que l'utilisateur a effectuées pendant la période donnée.
history.deleteAll()
Supprime toutes les visites de l'historique du navigateur.

Evénements

history.onTitleChanged
Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.
history.onVisited
Lancé chaque fois que l'utilisateur visite une page, en fournissant les données history.HistoryItem pour cette page.
history.onVisitRemoved

Lancé lorsqu'une URL est complètement supprimée de l'historique du navigateur.

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,