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

ChromeEdgeFirefoxFirefox for AndroidOpera
remove Oui Non53 *57 * Oui
removeCache Oui Non53 *57 * Oui
removeCookies Oui Non5356 Oui
removeDownloads Oui Non5357 Oui
removeFormData Oui Non5357 Oui
removeHistory Oui Non53 * Non Oui
removeLocalStorage Oui Non57 *57 * Oui
removePasswords Oui Non53 Non Oui
removePluginData Oui Non53 Non Oui
settings Oui Non5356 Oui

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,