recursal/MDN huggingface dataset:
contextualIdentities.create()
=============================

Crée une nouvelle identité contextuelle. Une fois créée, l'utilisateur pourra créer de nouveaux onglets appartenant à cette identité contextuelle, tout comme ils peuvent le faire avec les identités intégrées.

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

Syntaxe
-------


```js
var createContext = browser.contextualIdentities.create(
  details, // object
);
```

### Paramètres

`details`

`object`. Un objet contenant des propriétés pour la nouvelle identité contextuelle. Cela contient les propriétés suivantes :

`name`

`string`. Le nom de la nouvelle identité. Cela sera affiché dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet appartenant à l'identité. Il sera également affiché dans la barre d'URL pour les onglets appartenant à cette identité.

`color`

`string`. La couleur associée à la nouvelle identité. Cela sera utilisé pour mettre en évidence les onglets appartenant à cette identité. Vous pouvez fournir l'une des valeurs suivantes ici :

* "blue"
* "turquoise"
* "green"
* "yellow"
* "orange"
* "red"
* "pink"
* "purple"
* "toolbar"

`icon`

`string`. Le nom d'une icône à afficher dans la barre d'URL pour les onglets appartenant à cette identité. Vous pouvez fournir l'une des valeurs suivantes ici :

* "fingerprint"
* "briefcase"
* "dollar"
* "cart"
* "circle"
* "gift"
* "vacation"
* "food"
* "fruit"
* "pet"
* "tree"
* "chill"
* "fence"


### Valeur retournée

Une `Promise` qui sera remplie avec un `ContextualIdentity` qui décrit la nouvelle identité. Si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

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

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

Exemples
--------

Cet exemple crée une nouvelle identité contextuelle et enregistre son ID de cookie :


```js
function onCreated(context) {
  console.log(`New identity's ID: ${context.cookieStoreId}.`);
}

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

browser.contextualIdentities
  .create({
    name: "my-thing",
    color: "purple",
    icon: "briefcase",
  })
  .then(onCreated, onError);
```
contextualIdentities.onUpdated
==============================

Lancé lorsque les propriétés d'une identité contextuelle, telles que son nom, son icône ou sa couleur, sont modifiées. Les identités contextuelles peuvent être mises à jour par des extensions en utilisant l'API `contextualIdentities` , ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.

Syntaxe
-------


```js
browser.contextualIdentities.onUpdated.addListener(listener);
browser.contextualIdentities.onUpdated.removeListener(listener);
browser.contextualIdentities.onUpdated.hasListener(listener);
```


Events have three functions:

`addListener(listener)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer.

`hasListener(listener)`

Vérifiez si le `listener` est enregistré pour cet événement. Renvoie `true`s'il écoute, sinon `false`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

`changeInfo`

`object`. Un objet qui contient une seule propriété, `contextualIdentity`, qui est un objet `contextualIdentities.ContextualIdentity` représentant l'identité dont les propriétés ont été mises à jour.


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

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

Exemples
--------


```js
function handleUpdated(changeInfo) {
  console.log(`Updated: ${changeInfo.contextualIdentity.name}`);
}

browser.contextualIdentities.onUpdated.addListener(handleUpdated);
```
contextualIdentities.onRemoved
==============================

Lancé lorsqu'une nouvelle identité contextuelle est supprimée. Les identités contextuelles peuvent être supprimées par des extensions en utilisant l'API `contextualIdentities`, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.

Syntaxe
-------


```js
browser.contextualIdentities.onRemoved.addListener(listener);
browser.contextualIdentities.onRemoved.removeListener(listener);
browser.contextualIdentities.onRemoved.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(listener)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer.

`hasListener(listener)`

Vérifiez si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

`changeInfo`

`object`. Un objet qui contient une seule propriété, `contextualIdentity`, qui est un objet `contextualIdentities.ContextualIdentity` représentant l'identité qui a été supprimée.


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

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

Exemples
--------


```js
function handleRemoved(changeInfo) {
  console.log(`Removed: ${changeInfo.contextualIdentity.name}`);
}

browser.contextualIdentities.onRemoved.addListener(handleRemoved);
```
contextualIdentities.onCreated
==============================

Lancé lorsqu'une nouvelle identité contextuelle est créée. Les identités contextuelles peuvent être créées par des extensions en utilisant l'API `contextualIdentities`, ou directement par l'utilisateur, en utilisant l'interface utilisateur du navigateur.

Syntaxe
-------


```js
browser.contextualIdentities.onCreated.addListener(listener);
browser.contextualIdentities.onCreated.removeListener(listener);
browser.contextualIdentities.onCreated.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(listener)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer.

`hasListener(listener)`

Vérifiez si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

`changeInfo`

`object`. Un objet contenant une seule propriété, `contextualIdentity`, qui est un objet `contextualIdentities.ContextualIdentity` représentant l'identité créée.


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

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

Examples
--------


```js
function handleCreated(changeInfo) {
  console.log(`Created: ${changeInfo.contextualIdentity.name}`);
}

browser.contextualIdentities.onCreated.addListener(handleCreated);
```
contextualIdentities.remove()
=============================

Supprime une identité contextuelle, compte tenu de son ID de cookie.

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

Syntaxe
-------


```js
var removeContext = browser.contextualIdentities.remove(
  cookieStoreId, // string
);
```

### Paramètres

`cookieStoreId`

`string`. L'identifiant du cookie store de l'identité contextuelle. Étant donné que les identités contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identité contextuelle elle-même.

### Valeur retournée

Une `Promise` qui sera remplie avec un `ContextualIdentity` décrivant l'identité qui a été supprimée. Si l'identité n'a pas pu être trouvée ou si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

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

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

Exemples
--------

Cet exemple tente de supprimer l'identité contextuelle dont l'ID est "firefox-container-1" :


```js
function onRemoved(context) {
  if (!context) {
    console.error("Context not found");
  } else {
    console.log(`Removed identity: ${context.cookieStoreId}.`);
  }
}

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

browser.contextualIdentities
  .remove("firefox-container-1")
  .then(onRemoved, onError);
```
contextualIdentities.update()
=============================

Met à jour les propriétés d'une identité contextuelle, compte tenu de son ID de cookie.

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

Syntaxe
-------


```js
var createContext = browser.contextualIdentities.update(
  cookieStoreId, // string
  details, // object
);
```

### Paramètres

`cookieStoreId`

`string`. L'identifiant du cookie store de cette identité contextuelle. Étant donné que les identités contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identité contextuelle elle-même.

`details`

`object`. Un objet contenant de nouvelles valeurs pour les propriétés que vous souhaitez modifier. Cela peut contenir l'une des propriétés suivantes :

`name` Facultatif

`string`. Un nouveau nom pour l'identité. Cela sera affiché dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet dans l'identité. Il sera également affiché dans la barre d'URL pour les onglets appartenant à cette identité.

`color` Facultatif

`string`. Une nouvelle couleur pour l'identité. Cela sera utilisé pour mettre en évidence les onglets appartenant à cette identité. Vous pouvez fournir l'une des valeurs suivantes ici :

* "blue"
* "turquoise"
* "green"
* "yellow"
* "orange"
* "red"
* "pink"
* "purple"
* "toolbar"

`icon` Facultatif

`string`. Une nouvelle icône pour l'identité. Vous pouvez fournir l'une des valeurs suivantes ici :

* "fingerprint"
* "briefcase"
* "dollar"
* "cart"
* "circle"
* "gift"
* "vacation"
* "food"
* "fruit"
* "pet"
* "tree"
* "chill"
* "fence"


### Valeur retournée

Une `Promise` qui sera remplie avec un `ContextualIdentity` qui décrit l'identité mise à jour. Si l'identité n'a pas pu être trouvée ou si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

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

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

Exemples
--------

Cet exemple met à jour l'identité contextuelle dont l'ID est "firefox-container-1" pour avoir un nouveau nom, une nouvelle couleur et une nouvelle icône :


```js
function onUpdated(context) {
  console.log(`New identity's name: ${context.name}.`);
}

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

browser.contextualIdentities
  .update("firefox-container-1", {
    name: "my-thing",
    color: "purple",
    icon: "briefcase",
  })
  .then(onUpdated, onError);
```
contextualIdentitities.ContextualIdentity
=========================================

Le type **`contextualIdentities.ContextualIdentity`** décrit une identité contextuelle unique.

Type
----

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

`cookieStoreId`

`string`. L'ID du magasin de cookies pour l'identité. Puisque les identités contextuelles ne partagent pas les banques de cookies, elles servent d'identificateur unique.

`color`

`string`. La couleur pour l'identité. Cela sera montré dans les onglets appartenant à cette identité. Les valeurs suivantes sont valides :

* "blue"
* "turquoise"
* "green"
* "yellow"
* "orange"
* "red"
* "pink"
* "purple"
* "toolbar"

La valeur "toolbar" représente une couleur dépendant du thème. Les identités avec la couleur "toolbar" seront affichées dans la même couleur que le texte de la barre d'outils (correspondant à la clé thème `"toolbar_field_text"`).

`colorCode`

`string`. Un code hexadécimal représentant la couleur exacte utilisée pour l'identité. Par exemple : `"#37adff"`. Dans le cas particulier de la couleur "toolbar", `colorCode` est toujours `"#7c7c7d"`, quelle que soit la couleur affichée.

`icon`

`string`. Le nom d'une icône pour l'identité. Cela s'affichera dans la barre d'URL pour les onglets appartenant à cette identité. Les valeurs suivantes sont valides :

* "fingerprint"
* "briefcase"
* "dollar"
* "cart"
* "circle"
* "gift"
* "vacation"
* "food"
* "fruit"
* "pet"
* "tree"
* "chill"
* "fence"

`iconUrl`

`string`. Une URL complète resource:// pointant vers l'icône de l'identité. Par exemple : "resource://usercontext-content/fingerprint.svg".

`name`

`string`. Nom de l'identité. Cela s'affichera dans la barre d'URL pour les onglets appartenant à cette identité. Notez que les noms ne doivent pas nécessairement être uniques .

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

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
contextualIdentities.get()
==========================

Obtient des informations sur une identité contextuelle, compte tenu de son ID de cookie.

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

Syntaxe
-------


```js
var getContext = browser.contextualIdentities.get(
  cookieStoreId, // string
);
```

### Paramètres

`cookieStoreId`

`string`. L'identifiant du cookie store de cette identité contextuelle. Étant donné que les identités contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identité contextuelle elle-même.

### Valeur retournée

Une `Promise` qui sera remplie avec un `ContextualIdentity` qui décrit l'identité. Si l'identité n'a pas pu être trouvée ou si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

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

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

Exemples
--------

Cet exemple tente de récupérer l'identité contextuelle dont l'ID est "firefox-container-1":


```js
function onGot(context) {
  if (!context) {
    console.error("Context not found");
  } else {
    console.log(`Name: ${context.name}`);
  }
}

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

browser.contextualIdentities.get("firefox-container-1").then(onGot, onError);
```
contextualIdentities.query()
============================

Obtient des informations sur toutes les identités contextuelles ou sur les identités contextuelles correspondant à un argument de filtre donné.

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

Syntaxe
-------


```js
var getContext = browser.contextualIdentities.query(
  details, // object
);
```

### Paramètres

`details`

`object`. Un objet qui peut être utilisé pour filtrer les identités contextuelles renvoyées. Cela peut contenir l'une des propriétés suivantes :

`name` Facultatif

`string`. Renvoie uniquement les identités contextuelles avec ce nom.


### Valeur retournée

Une `Promise` qui sera remplie avec un tableau d'objets `ContextualIdentity` chacun décrivant une seule identité. Si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

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

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

Exemples
--------

Retrieve all contextual identities, and log their names :


```js
function onGot(contexts) {
  for (let context of contexts) {
    console.log(`Name: ${context.name}`);
  }
}

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

browser.contextualIdentities.query({}).then(onGot, onError);
```


Récupérez toutes les identités contextuelles dont les noms sont "my-thing", et consignez leurs noms :


```js
function onGot(contexts) {
  for (let context of contexts) {
    console.log(`Name: ${context.name}`);
  }
}

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

browser.contextualIdentities
  .query({
    name: "my-thing",
  })
  .then(onGot, onError);
```

### Example extensions

* contextual-identities
management.onUninstalled()
==========================

Action quand une extension est désinstallée.

L'API requière l'API de permission "management".

Syntaxe
-------


```js
browser.management.onUninstalled.addListener(listener);
browser.management.onUninstalled.removeListener(listener);
browser.management.onUninstalled.hasListener(listener);
```


Les événement ont trois fonctions :

`addListener(callback)`

Ajoutez un auditeur à cet événement.

`removeListener(listener)`

L'argument de l'auditeur est l'auditeur à supprimer.

`hasListener(listener)`

Vérifie si l'auditeur est enregistré à l'événement. Renvoie `true` s'il est à l'écoute, sinon `false` .

Syntaxe addListener
-------------------

### Paramètres

`function`

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

`info`

`ExtensionInfo`: informations de l'extension qui a été désinstallé.


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

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

Exemples
--------

Enregistrez les noms des extensions lorsqu'ils sont désinstallés :


```js
browser.management.onUninstalled.addListener((info) => {
  console.log(info.name + " was uninstalled");
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.management`. Cette documentation est dérivée de `management.json` dans le code de Chromium code.

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.
management.setEnabled()
=======================

Active ou désactive l'extension ajoutée.

Cette fonction doit généralement être appelée dans le contexte d'une action utilisateur, comme le gestionnaire de clics d'un bouton. Le navigateur peut également demander à l'utilisateur de confirmer le changement.

Cette API requière l'API permission "management".

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var settingEnabled = browser.management.setEnabled(
  id, // string
  enabled, // boolean
);
```

### Paramètres

`id`

`string`. ID de l'extension pour activer ou désactiver.

`enabled`

`boolean`. Que ce soit pour active ou désactiver l'extension.

### Valeur retournée

Une `Promise` qui sera remplie sans arguments lorsque l'extension a été désactivé ou activé.

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

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

Exemples
--------

Actviez / Désactivez l'option pour l'extension dont l'ID est "my-add-on":


```js
var id = "my-add-on";

function toggleEnabled(id) {
  var getting = browser.management.get(id);
  getting.then((info) => {
    browser.management.setEnabled(id, !info.enabled);
  });
}

toggleEnabled(id);
```

### Example extensions

* theme-switcher

**Note :**

Cette API est basée sur l'API Chromium `chrome.management`. Cette documentation est dérivée de `management.json` dans le code de Chromium code.

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.
management.onDisabled()
=======================

Action quand l'extension est désactivée.

L'API requière l'API de permission "management".

Syntaxe
-------


```js
browser.management.onDisabled.addListener(listener);
browser.management.onDisabled.removeListener(listener);
browser.management.onDisabled.hasListener(listener);
```


Les événement ont trois fonctions :

`addListener(callback)`

Ajoutez un auditeur à cet événement.

`removeListener(listener)`

L'argument de l'auditeur est l'auditeur à supprimer.

`hasListener(listener)`

Vérifie si l'auditeur est enregistré à l'événement. Renvoie `true` s'il est à l'écoute, sinon `false` .

Syntaxe addListener
-------------------

### Paramètres

`function`

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

`info`

`ExtensionInfo`: informations de l'extension qui a été désactivé


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

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

Exemples
--------

Enregistrez les noms des extensions lorsqu'ils sont désactivés.


```js
browser.management.onDisabled.addListener((info) => {
  console.log(info.name + " was disabled");
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.management`. Cette documentation est dérivée de `management.json` dans le code de Chromium code.

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.
management.get()
================

Récupère un objet `ExtensionInfo` contenant des informations sur l'extension spécifiée.

Cette API requière la permission API "management"

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingInfo = browser.management.get(
  id, // string
);
```

### Paramètres

`id`

`string`. l'ID de l'extension dont vous souhaitez récupérer les informations.

### Valeur retournée

Une `Promise` qui sera remplie avec un objet `ExtensionInfo` , contenant les informations sur l'extension. La promise sera rejetée si aucune extension avec l'ID donné n'est installée ou si l'appelant ne peut pas accéder à l'extension.

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

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

Exemples
--------

Enregistrez le nom de l'extension dont l'ID est "my-add-on":


```js
var id = "my-add-on";

function got(info) {
  console.log(info.name);
}

var getting = browser.management.get(id);
getting.then(got);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.management`. Cette documentation est dérivée de `management.json` dans le code de Chromium code.

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.