history

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

Si vous recherchez des informations sur l'historique de session du navigateur, consultez l'interface historique.

Note : 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é des navigateurs

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.

Example extensions

Note :

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.