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.

Notez : 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

BCD tables only load in the browser

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.