recursal/MDN huggingface dataset:
browsingData.settings()
=======================

Les navigateurs disposent d'une fonction "Effacer l'historique" intégrée, qui permet à l'utilisateur d'effacer différents types de données de navigation. Cela a une interface utilisateur qui permet à l'utilisateur de sélectionner le type de données à supprimer (par exemple l'historique, les téléchargements, ...) et à quelle distance remonter dans le temps pour supprimer des données.

Cette fonction renvoie la valeur actuelle de ces paramètres.

Notez que tous les types de données ne peuvent pas toujours être supprimés via l'interface utilisateur et certaines options d'interface utilisateur peuvent correspondre à plusieurs types de données.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var getSettings = browser.browsingData.settings();
```

### Paramètres

Aucun.

### Valeur retournée

Une `Promise` qui sera remplie avec un objet contenant les informations sur les paramètres. Cet objet a trois propriétés :

`options`

``browsingData.RemovalOptions``. Un objet `RemovalOptions` décrivant les options de suppression actuellement sélectionnées.

`dataToRemove`

``browsingData.DataTypeSet``. Cela contiendra une propriété pour chaque type de données pouvant être basculé dans l'interface utilisateur du navigateur. Chaque propriété aura une valeur `true` si ce type est sélectionné pour la suppression et `false` dans le cas contraire.

`dataRemovalPermitted`

``browsingData.DataTypeSet``. Cela contiendra une propriété pour chaque type de données pouvant être basculé dans l'interface utilisateur du navigateur. Chacune aura la valeur `true` si l'administrateur du périphérique a autorisé l'utilisateur à supprimer ce type, et `false` dans le cas contraire.

Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Paramètres des Logs courrants :


```js
function onGotSettings(settings) {
  console.log(settings.options);
  console.log(settings.dataToRemove);
  console.log(settings.dataRemovalPermitted);
}

function onError(error) {
  console.error(error);
}

browser.browsingData.settings().then(onGotSettings, onError);
```


**Note :**

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.
browsingData.removeLocalStorage()
=================================

Efface tout le stockage local créé par des sites Web.

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions` pour :

* Effacer uniquement les objets de stockage locaux créés après un délai donné
* Controler si vous souhaitez effacer uniquement les objets de stockage locaux créés par des pages Web normales ou supprimer des objets créés par des applications et des extensions hébergées.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeLocalStorage(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut etre utilisé pour effacer uniquement les objets de stockage locaux créés par des pages Web normales ou pour effacer des objets créés par des applications et des extensions hébergées.

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprime tout le stockage local :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeLocalStorage({}).then(onRemoved, onError);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.browsingData`.
browsingData.removeCache()
==========================

Effacer le cache du navigateur.

Notez que cette fonction puisse prendre un objet `browsingData.RemovalOptions`, elle sera ignorée. Le cache entier est toujours effacé lors de l'utilisation de cette fonction.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeCache(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions` Facultatif

`object`. Un objet `browsingData.RemovalOptions`. Ce paramètre n'a aucun effet

### Valeur retournée

Une `Promise` qui sera rempli sans arguments lorsque la suppression est terminée. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Effacer le cache du navigateur :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeCache({}).then(onRemoved, onError);
```


**Note :**

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.
browsingData.removePasswords()
==============================

Efface les mots de passes enregistrés

Vous pouvez utiliser le paremètre `removalOptions`, qui est un objet `browsingData.RemovalOptions` pour :

* Effacer uniquement les mots de passe enregistrés après un certain temp
* Contrôlez si vous souhaitez supprimer les mots de passe enregistrés sur les pages Web normales ou effacer les mots de passe enregistrés sur les applications et les extensions hébergées.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removePasswords(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut être utilisé pour effacer uniquement les mots de passe enregistrés après un certain temps, et pour effacer les mots de passe enregistrés sur les pages Web normales ou pour effacer les mots de passe enregistrés sur les applications et les extensions hébergées.

### Valeur retournée

Une `Promise` qui sera remplie sans arguments lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer les mots de passe enregistrés la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removePasswords({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprime tous les mots de passe enregistrés :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removePasswords({}).then(onRemoved, onError);
```


**Note :**

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

Le type **`browsingData.RemovalOptions`** contient des options permettant de contrôler certains aspects de la suppression des données de navigation.

Type
----

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes:

`hostnames` Facultatif

`Array` of `string`. Cette propriété s'applique uniquement aux cookies et aux éléments de stockage locaux. Ne supprimez que les cookies et les éléments de stockage locaux associés à ces noms d'hôte.

Vous devez indiquer ici un nom d'hôte, sans protocole (par exemple : `google.com` et non `https://google.com`). Vous pouvez utiliser l'interface `URL` pour analyser une URL brute et récupérer uniquement le nom d'hôte. Les sous-domaines d'un nom d'hôte donné ne seront pas supprimés: vous devez explicitement lister les sous-domaines.

`originTypes` Facultatif

`object`. Permet de contrôler si les données doivent être supprimées uniquement des pages Web normales ou des applications et extensions Web hébergées. Si cette option est omise, seules les données des pages Web normales ("`unprotectedWeb`") sont supprimées. Avant de supprimer des données d'applications ou d'extensions Web, veillez à ce que ce soit vraiment ce que l'utilisateur souhaite.

Cet objet peut contenir l'une des propriétés suivantes :

`unprotectedWeb` Facultatif

`boolean`. Si présent et `true`, supprime les données de la pages Web normales.

`protectedWeb` Facultatif

`boolean`. Si présent et `true`, supprime les données de site Web qui ont été installés en tant qu'applications hébergées.

`extension` Facultatif

`boolean`. Si présent et `true`, supprime les données d'extensions.


`since` Facultatif

`number`. Jusqu'à quand remontent les données, données en millisecondes depuis l'époque UNIX. Notez que lorsque vous supprimez le cache du navigateur, le cache entier est toujours supprimé et cette option est ignorée. Si la propriété `since` est omise, la valeur par défaut est 0, ce qui signifie "pour toujours".

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

Cette API est basée sur l'API Chromium `chrome.browsingData`.
browsingData.removePluginData()
===============================

Efface les données stockées par les plugins du navigateur.

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions`, pour :

* effacer seulement les données du plugins stockées après un temps donné
* controler si vous souhaitez effacer uniquement les données stockées par les plugins qui s'exécutent dans les pages Web normales ou effacer les données par les plugins qui s'exécutent dans les applications et les extensions hébergées.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removePluginData(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut être utilisé pour effacer uniquement les données de plugin stockées après un certain temps, et pour effacer uniquement les données stockées par des plugins fonctionnant sur des pages web normales ou pour effacer des données stockées par des plugins fonctionnant dans des applications et extensions hébergées.

### Valeur retournée

Une `Promise` qui sera rempli sans arguments lorsque la suppression est terminée. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer les données stockées par les plugins au cours de la dernière semaine :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removePluginData({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprimer toutes les données stockées par les plugins :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removePluginData({}).then(onRemoved, onError);
```


**Note :**

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.
browsingData.removeFormData()
=============================

Efface les données que le navigateur a enregistré pour les formulaires de remplissage automatique.

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions`, pour :

* Efface uniquement les données de formulaire entrées après une heure donnée
* Contrôle si vous souhaitez supprimer uniquement les données saisies dans les pages Web normales ou effacer les données saisies dans les applications et extensions hébergées.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeFormData(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`object`. Un objet `browsingData.RemovalOptions`, qui peut être utilisé pour effacer uniquement les données de formulaire saisies après une heure donnée, et pour effacer uniquement les données saisies dans les pages Web normales ou pour effacer les données saisies dans les applications hébergées et des extensions aussi.

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer les données de formulaire enregistrées la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeFormData({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprimer tous les données de formulaire enregistrées :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeFormData({}).then(onRemoved, onError);
```


**Note :**

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

Le type **`browsingData.DataTypeSet`** décrit un ensemble de types de données.

Il contient un certains nombres de propriétés booléennes. Le nom de chaque propriété est le nom d'un type particulier de données de navigations : "Téléchargements", "historique" et ainsi de suite. Toutes les propriétés sont facultatives.

Ce type est utilisé :

* dans `browsingData.remove()` pour décrire les types de données à supprimer
* dans `browsingData.settings()` pour décrire les types de données actuellement sélectionnés dans la fonction "effacer l'historique" du navigateur.
Type
----

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

`cache` Facultatif

`boolean`. Le cache du navigateur

`cookies` Facultatif

`boolean`. Cookies acquis en cours de la navigation.

`downloads` Facultatif

`boolean`. L'historique de téléchargement de l'utilisateur.

`fileSystems` Facultatif

`boolean`. Les systèmes de fichiers du site Web.

`formData` Facultatif

`boolean`. Données de formulaire enregistrées, pour la saisie semi-automatique.

`history` Facultatif

`boolean`. L'histoire de navigation de l'utilisateur.

`indexedDB` Facultatif

`boolean`. Données IndexedDB.

`localStorage` Facultatif

`boolean`. Données de stockage local.

`passwords` Facultatif

`boolean`. Mots de pass enregistrés, pour la saisie semi-automatique.

`pluginData` Facultatif

`boolean`. Données stockées associées aux plugins.

`serverBoundCertificates` Facultatif

`boolean`. Certificats liés au serveur stockés.

`serviceWorkers` Facultatif

`boolean`. Données mises en cache par les travailleurs du service.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

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.
browsingData.removeHistory()
============================

Efface l'enregistrement des pages Web que l'utilisateur a visité (historique de navigation).

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions` pour :

* Effacer uniquement les eenregistrements des pages Web visitées après un certain temps.
* Contrôlez si vous souhaitez effacer uniquement les enregistrements des pages web normales ou effacer les enregistrements des applications hébergées et des extensions.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeHistory(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut-être utilisé pour effacer uniquement les enregistrements des pages Web visitées après un certain temp, et pour effacer uniquement les enregistrements des pages Web normales ou pour effacer les enregistrements des applications hébergées et extensions aussi bien.

### Valeur retournée

Une `Promise` sera rempli sans arguments lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer les enregistrements de la page visitées de la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeHistory({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprimer tous les enregistrements des pages visitées :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeHistory({}).then(onRemoved, onError);
```


**Note :**

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.
browsingData.removeDownloads()
==============================

Efface l'historique de téléchargement du navigateur. Notez que cela ne supprime pas les objets téléchargés eux-mêmes, seulement les enregistrements de téléchargements dans l'historique du navigateur.

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions` pour :

* Efface les enregistrements des élements téléchargés après un temps donné
* contrôle si vous souhaitez effacer uniquement les enregistrements d'éléments téléchargés à partir de pages Web normales ou pour supprimer également les enregistrements des applications hébergées et des extensions.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeDownloads(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut-être utilisé pour effacer uniquement les enregistrements créés après une heure donnée, et pour effacer uniquement les enregistrements d'éléments téléchargés depuis les pages Web normales ou pour effacer des enregistrements d'applications hébergées et extensions aussi bien.

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprime les enregistrements d'objets téléchargés la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeDownloads({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprime tous les enregistrements d'objets téléchargés :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeDownloads({}).then(onRemoved, onError);
```


**Note :**

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.
browsingData.remove()
=====================

Supprime les données de navigation spécifiées.

Les données de navigation à supprimer sont spécifiées dans l'option `dataTypes`, qui est un objet `browsingData.DataTypeSet`.

Vous pouvez utiliser l'option `removalOptions`, qui est un objet `browsingData.RemovalOptions`, pour contrôler à quelle distance remonter dans le temps pour supprimer des données et supprimer les données uniquement à partir de pages Web normales ou pour supprimer des données hébergées d'applications et extensions aussi.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.remove(
  removalOptions, // RemovalOptions object
  dataTypes, // DataTypeSet object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut être utilisé pour contrôler à quelle distance remonter dans le temps pour supprimer des données, et si vous souhaitez supprimer des données des applications Web hébergées et des extensions ou simplement des pages Web normales.

`dataTypes`

`object`. Un objet `browsingData.DataTypeSet`, décrit les types de données à supprimer (par exemple, historique, les téléchargements,...).

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer l'historique des téléchargements et de l'histoire de navigation de la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .remove({ since: oneWeekAgo }, { downloads: true, history: true })
  .then(onRemoved, onError);
```


Supprimer tout l'historique de téléchargement et de navigation :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData
  .remove({}, { downloads: true, history: true })
  .then(onRemoved, onError);
```

### Example extensions

* forget-it

**Note :**

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.