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 :
- Recherchez dans des pagesqui apparaissent dans l'historique du navigateur
- Supprimer des pages individuelles de l'historique du navigateur
- Ajouter des pages à l'historique du navigateur
- Supprimer toutes les pages de l'historique du navigateur.
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 :
- Récupérer l'ensemble des visites effectuées par l'utilisateur sur une page particulière
- Supprimer les visites à toutes les pages faites pendant une période de temps.
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.HistoryItemcorrespondant 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.HistoryItempour cette page. history.onVisitRemoved-
Lancé lorsqu'une URL est complètement supprimée de l'historique du navigateur.
Compatibilité des navigateurs
BCD tables only load in the browser
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.