Permet aux extensions d'effacer les données accumulées pendant la navigation de l'utilisateur.

Dans l'API browsingData, les données de navigations sont divisées en types :

  • cache du navigateur
  • cookies
  • Téléchargements
  • historique
  • stockage local
  • données du plugin
  • données de formulaire enregistrées
  • Mots de passe enregistrés

Vous pouvez utiliser la fonction browsingData.remove() pour supprimer toute combinaison de ces types. Il existe également des fonctions dédiées pour supprimer chaque type particulier de données, comme removePasswords(), removeHistory() etc.

Toutes les fonctions browsingData.remove[X]() prennent un objet  browsingData.RemovalOptions que vous pouvez utiliser pour contrôler deux autres aspects de la suppression des données :

  • dans quelle mesure remonter dans le temps pour supprimer des données
  • qu'il s'agisse de supprimer des données uniquement de pages Web normales ou d'applications Web hébergées et de modules complémentaires. Notez que cette option n'est pas encore supportée dans Firefox.

Enfin, cette API vous donne une fonction browsingData.settings() qui vous donne la valeur actuelle des paramètres de la fonction "Effacer l'historique" du navigateur.

Pour utiliser cette API, vous devez disposer de l'API permission "browseData".

Types

browsingData.DataTypeSet
Objet utilisé pour spécifier le type de données à supprimer: par exemple, l'historique, les téléchargements, les mots de passe, etc.
browsingData.RemovalOptions
Objet utilisé pour spécifier le retour arrière des données, et la suppression des données ajoutées par le biais de la navigation Web normale, des applications hébergées ou des modules complémentaires.

Méthodes

browsingData.remove()
Supprime les données de navigation pour les types de données spécifiés.
browsingData.removeCache()
Efface le cache du navigateur.
browsingData.removeCookies()
Supprime les cookies
browsingData.removeDownloads()
Supprime la liste des fichiers téléchargés.
browsingData.removeFormData()
Efface les données de formulaire enregistrées.
browsingData.removeHistory()
Efface l'historique du navigateur.
browsingData.removeLocalStorage()
Efface tout stockage local créé par des sites web.
browsingData.removePasswords()
Efface les mots de passe enregistrés.
browsingData.removePluginData()
Efface les données associées aux plugins.
browsingData.settings()
Obtient la valeur actuelle des paramètres dans la fonction "Effacer l'historique" du navigateur

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
DataTypeSet.cacheChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
DataTypeSet.cookiesChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
DataTypeSet.downloadsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
DataTypeSet.fileSystemsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.formDataChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
DataTypeSet.historyChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
DataTypeSet.indexedDBChrome Support complet OuiEdge Aucun support NonFirefox Support complet 57Opera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.localStorageChrome Support complet OuiEdge Aucun support NonFirefox Support complet 57Opera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.passwordsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.pluginDataChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.serverBoundCertificatesChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
DataTypeSet.serviceWorkersChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
RemovalOptions.hostnamesChrome Aucun support NonEdge Aucun support NonFirefox Support complet 56Opera Aucun support NonFirefox Android Aucun support Non
RemovalOptions.originTypesChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Support complet OuiFirefox Android Aucun support Non
RemovalOptions.sinceChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes since is not supported with the following data types: cache, indexedDB, localStorage, and serviceWorkers.
Opera Support complet OuiFirefox Android Support complet 56
Notes
Support complet 56
Notes
Notes since is not supported with the following data types: cache, indexedDB, localStorage, and serviceWorkers.
removeChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes Specifying dataTypes.history will also remove download history and service workers.
Opera Support complet OuiFirefox Android Support complet 57
Notes
Support complet 57
Notes
Notes Specifying dataTypes.history will also remove download history and service workers.
removeCacheChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes removalOptions.since is not supported.
Opera Support complet OuiFirefox Android Support complet 57
Notes
Support complet 57
Notes
Notes removalOptions.since is not supported.
removeCookiesChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56
removeDownloadsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 57
removeFormDataChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 57
removeHistoryChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes This function also removes download history and service workers.
Opera Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes See bug 1363010. browser.history.remove(options, {history:true}) can be used instead.
removeLocalStorageChrome Support complet OuiEdge Aucun support NonFirefox Support complet 57
Notes
Support complet 57
Notes
Notes removalOptions.since is not supported.
Opera Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes The method is defined but returns a rejected promise.
removePasswordsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes See bug 1363012.
removePluginDataChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Aucun support Non
settingsChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53Opera Support complet OuiFirefox Android Support complet 56

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.browsingData.

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,