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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
HistoryItemChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non
TransitionTypeChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50Opera Support complet OuiFirefox Android Aucun support Non
VisitItemChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50Opera Support complet OuiFirefox Android Aucun support Non
addUrlChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non
deleteAllChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non
deleteRangeChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non
deleteUrlChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non
getVisitsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50Opera Support complet OuiFirefox Android Aucun support Non
onTitleChangedChrome Aucun support NonEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
onVisitRemovedChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50Opera Support complet OuiFirefox Android Aucun support Non
onVisitedChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50
Notes
Support complet 50
Notes
Notes Before version 56, the result object's 'title' was always an empty string. From version 56 onwards, it is set to the last known title, if that is available, or an empty string otherwise.
Opera Support complet OuiFirefox Android Aucun support Non
searchChrome Support complet OuiEdge Aucun support NonFirefox Support complet 49Opera Support complet OuiFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

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,