recursal/MDN huggingface dataset:
tabs.MutedInfoReason
====================

Spécifie la raison pour laquelle un onglet a été désactivé ou désactivé.

Type
----

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

"capture"

La capture d'onglets a commencé, forçant un changement d'état muet.

"extension"

Une extension définit l'état muet. Si c'est la raison, `extensionId` dans `tabs.mutedInfo` contiendra l'ID de l'extension responsable.

"user"

L'utilisateur définit l'état muet.

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.tabs`. Cette documentation est dérivée de `tabs.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.
browserSettings.zoomFullPage
============================

Un objet `BrowserSetting` dont la valeur sous-jaccente est un booléen.

Par défaut, le zoom s'applique à la page web entière. En utilisant le Zoom Text Only setting les utilisateurs/utilisatrices peuvent choisir de zoomer uniquement le texte de la page. Ce réglage permet à une web extension de modifier et de déterminer la valeur du paramètre, le zoom est appliqué à la page entière ou bien au texte seulement.

Valeurs du paramètre:

* `true`: le zoom s'applique à la page web en entier (par défaut).
* `false`: le zoom s'applique au texte de la page web seulement.
Compatibilité des navigateurs
-----------------------------

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

Exemples
--------

Mettre le réglage à `false`:


```js
function afficherResultat(resultat) {
  console.log(`Le paramètre a été modifié: ${resultat}`);
}

browser.browserSettings.zoomFullPage
  .set({ value: false })
  .then(afficherResultat);
```
browserSettings.webNotificationsDisabled
========================================

Un objet `BrowserSetting` qui peut être utilisé pour empêcher les sites Web d'afficher des `Notifications` à l'aide de l'API Web de notifications.

L'API `Notifications` est utilisée pour afficher les notifications de bureau à l'utilisateur. Il existe trois niveaux d'autorisation pour les notifications : *allow*, *deny*, et *prompt*. Les utilisateurs peuvent définir cette autorisation pour chaque site. Si l'utilisateur n'a pas défini d'autorisation pour un site particulier, le navigateur reviendra à une autorisation globale, qui sera par défaut *invité*e.

Définir `browserSettings.webNotificationsDisabled` à `true` change l'autorisation globale à *refuser*.

Notez que cela n'affectera pas les sites pour lesquels l'utilisateur a défini une préférence par site. Par exemple, si l'utilisateur définit https://example.org pour *autoriser*, et une extension place ensuite `browserSettings.webNotificationsDisabled` à `true`, alors les pages sous https://example.org seront toujours autorisées à afficher des notifications..

Si vous définissez `browserSettings.webNotificationsDisabled` à `false` la valeur par défaut globale est rétablie.

Notez que ce paramètre n'a aucun effet sur les notifications créées par des extensions à l'aide de l'API de `notifications`.

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

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

Exemples
--------

Basculer le paramètre :


```js
async function toggleWebNotifications() {
  let current = await browser.browserSettings.webNotificationsDisabled.get({});
  console.log(`Current value: ${current.value}`);
  browser.browserSettings.webNotificationsDisabled.set({
    value: !current.value,
  });
}

browser.browserAction.onClicked.addListener(() => {
  toggleWebNotifications();
});
```
browserSettings.newTabPosition
==============================

Un objet `BrowserSetting` qui peut être utilisé pour contrôler la position des onglets nouvellement ouverts par rapport aux onglets déjà ouverts.

La valeur sous-jacente est une chaîne qui peut prendre l'une des trois valeurs suivantes :

* "afterCurrent": ouvre tous les nouveaux onglets à côté de l'onglet actuel.
* "relatedAfterCurrent": La valeur par défaut. Ouvrez les nouveaux onglets à côté de l'onglet en cours s'ils sont liés à l'onglet en cours (par exemple, s'ils ont été ouverts via un lien dans l'onglet en cours). Sinon, ouvrez les nouveaux onglets à la fin de la bande d'onglets.
* "atEnd": ouvre tous les onglets à la fin de la bande d'onglets.
Compatibilité des navigateurs
-----------------------------

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

Exemples
--------

Ce code définit la valeur à "afterCurrent" puis enregistre la nouvelle valeur :


```js
async function setAfterCurrent() {
  let result = await browser.browserSettings.newTabPosition.set({
    value: "afterCurrent",
  });
  console.log(`Result: ${result}`);
  let newValue = await browser.browserSettings.newTabPosition.get({});
  console.log(`New value: ${newValue.value}`);
}
```
browserSettings.cacheEnabled
============================

Un objet `BrowserSetting` qui peut être utilisé pour activer ou désactiver globalement le cache du navigateur.

La valeur sous-jacente est un booléen.

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

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

Exemples
--------

Obtenir une valeur actuelle de ce paramètre :


```js
function logResult(result) {
  console.log(`Current value: ${result.value}`);
  console.log(`Current level of control: ${result.levelOfControl}`);
}

browser.browserSettings.cacheEnabled.get({}).then(logResult);
```


Désactivation du cache du navigateur :


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.cacheEnabled.set({ value: false }).then(logResult);
```
browserSettings.zoomSiteSpecific
================================

Un objet `BrowserSetting` dont la valeur sous-jaccente est un booléen.

Cette propriété contrôle le réglage de configuration `browser.zoom.siteSpecific`, qui règle comment le zoom est appliqué aux sites et onglets.

Si `browser.zoom.siteSpecific` est à vrai, les opérations de zoom s'appliquent à toutes les pages du même site selon les règles :

* quand une page charge, si il existe un niveau de zoom pour ce site alors il est appliqué par le navigateur sinon le niveau de zoom par défaut "global" est appliqué.
* quand le niveau de zoom change pour une page, le niveau des autres pages (dans d'autres onglets) de ce site sont mises à jour.

Si la préférence `browser.zoom.siteSpecific` est à faux, les opérations de zoom s'appliquent uniquement à l'onglet actif selon les règles :

* quand un nouvel onglet s'ouvre, le niveau de zoom par défaut "global" est appliqué.
* quand le niveau de zoom change dans un onglet, il sera appliqué durant toute la navigation dans cet onglet et n'affectera pas le niveau de zoom des autres onglets.

Lors de l'installation de Firefox, `browser.zoom.siteSpecific` est à vrai.

Si `privacy.websites``.resistFingerprinting` est à vrai, ce réglage ne peut pas être changé et le niveau de zoom est appliqué sur le schéma par-onglet.

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

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

Exemples
--------

Mettre le réglage à `false`:


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.zoomSiteSpecific.set({ value: false }).then(logResult);
```
browserSettings.useDocumentFonts
================================

Un objet `BrowserSetting` dont la valeur sous-jacente est un booléen.

Par défaut, bien sûr, les pages Web peuvent spécifier les polices qu'ils veulent utiliser les propriétés CSS comme `font-family`. Ce paramètre permet à une extension d'indiquer à Firefox d'ignorer les polices spécifiées par la page et d'utiliser uniquement les polices système.

Sa valeur sous-jacente est un booléen :

* `true`: utilise les polices spécifiées par la page Web. C'est la valeur par défaut.
* `false`: utilise les polices du système.
Compatibilité des navigateurs
-----------------------------

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

Exemples
--------

Définissez le paramètre sur `false`:


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.useDocumentFonts.set({ value: false }).then(logResult);
```
browserSettings.openSearchResultsInNewTabs
==========================================

Un objet `BrowserSetting` dont la valeur sous-jacente est un booléen.

Si la valeur est définie à `true`, lorsque l'utilisateur sélectionne un terme dans la zone de recherche du navigateur, les résultats de la recherche s'affichent dans un nouvel onglet. Si la valeur est `false` (valeur par défaut), les résultats de la recherche apparaissent dans l'onglet en cours.

Notez que cela n'affecte pas le comportement lors de la sélection des éléments de omnibox/awesomebar, uniquement la zone de recherche dédiée..

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

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

Exemples
--------

Définissez le paramètre sur `true`:


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.openSearchResultsInNewTabs
  .set({ value: true })
  .then(logResult);
```
browserSettings.openUrlbarResultsInNewTabs
==========================================

Un objet `BrowserSetting` dont la valeur sous-jacente est un booléen.

Quand l'utilisateur facalise la barre d'adresse et commence à taper, le navigateur propose des suggestions de saisie semi-automatique : une liste déroulante de pages web basée sur l'entrée incomplète de l'utilisateur et son historique de navigation.

Si la valeur est `true`, alors lorsque l'utiliseur sélectionne l'un des éléments, l'élément est ouvert dans un nouvel onglet. Si la valeur est `false` (valeur par défaut) l'élément est ouvert dans l'onglet en cours.

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

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

Exemples
--------

Définit le paramètre à `true`:


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.openUrlbarResultsInNewTabs
  .set({ value: true })
  .then(logResult);
```
browserSettings.closeTabsByDoubleClick
======================================

Un objet `BrowserSetting` qui peut être utilisé pour activer ou désactiver la possibilité pour l'utilisateur de fermer un onglet en double-cliquant.

La valeur sous-jacente est un booléen.

Par défaut, closeTabsByDoubleClick est faux. Le réglage peut être modifié par l'utilisateur dans about:config.

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

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

Un objet `BrowserSetting` dont la valeur sous-jacente est un booléen.

Si la valeur est `true`, alors lorsque l'utilisateur sélectionne un signet, il sera ouvert dans un nouvel onglet. Si la valeur est `false` (valeur par défaut), les marque-pages sont ouverts dans l'onglet en cours.

Exemples
--------

Définissez le paramètre sur `true`:


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.openBookmarksInNewTabs
  .set({ value: true })
  .then(logResult);
```

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

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

Un objet `BrowserSetting` qui détermine si le protocole FTP est activé dans le navigateur.

La valeur sous-jaccente est un booléen.

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

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

Exemples
--------

Changer le réglage:


```js
function toggleAllowFtp() {
  function toggle(current) {
    console.log(`Valeur actuelle: ${current.value}`);
    browser.browserSettings.ftpProtocolEnabled.set({ value: !current.value });
  }

  browser.browserSettings.ftpProtocolEnabled.get({}).then(toggle);
}

browser.browserAction.onClicked.addListener(() => {
  toggleAllowFtp();
});
```
browserSettings.homepageOverride
================================

Un objet `BrowserSetting` qui peut être utilisé pour obtenir une chaîne représentant l'URL actuellement définie comme page d'accueil du navigateur.

Notez qu'il s'agit d'un paramètre en lecture seule. Pour changer la page d'accueil, voir chrome\_settings\_overrides.

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

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

Exemples
--------

Obtenez la valeur actuelle de l'URL de la page d'accueil :


```js
browser.browserSettings.homepageOverride.get({}).then((result) => {
  console.log(result.value);
});
```
browserSettings.newTabPageOverride
==================================

Un objet `BrowserSetting` qui peut être utilisé pour obtenir une chaîne représentant l'URL de la page "nouvel onglet": c'est-à-dire, la page chargée lorsque l'utilisateur ouvre une nouvelle onglet vide.

Notez qu'il s'agit d'un paramètre en lecture seule.

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

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

Exemples
--------

Obtenir la valeur actuelle de la nouvelle URL de l'onglet :


```js
browser.browserSettings.newTabPageOverride.get({}).then((result) => {
  console.log(result.value);
});
```
browserSettings.overrideDocumentColors
======================================

Un objet `BrowserSetting` dont la valeur sous-jacente est une chaîne.

Firefox permet à l'utilisateur de définir ses propres couleurs pour les arrière-plans et le texte du document. Par défaut, ces valeurs ne sont appliquées que lorsqu'un thème à fort contraste est sélectionné (un thème à contraste élevé est une caractéristique de certaines interfaces utilisateur du système d'exploitation qui augmente le contraste pour une meilleure accessibilité). Cependant, les utilisateurs peuvent également choisir d'appliquer ces couleurs toujours ou jamais. Ce paramètre du navigateur expose cette préférence.

Sa valeur sous-jacente est une chaîne qui peut prendre l'une des valeurs suivantes:

* "high-contrast-only": applique les choix de l'utilisateur uniquement lorsqu'un thème à contraste élevé est sélectionné. C'est la valeur par défaut.
* "never": n'applique jamais les choix de l'utilisateur
* "always": Toujours appliquer les choix de l'utilisateur.
Compatibilité des navigateurs
-----------------------------

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

Exemples
--------

Définissez le paramètre sur "always":


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.overrideDocumentColors
  .set({ value: "always" })
  .then(logResult);
```
contextMenuShowEvent
====================

Un objet `BrowserSetting` qui détermine si le menu contextuel du navigateur est affiché sur l'événement mouseup ou sur l'événement mousedown.

Sa valeur sous-jacente est une chaîne qui peut être "mouseup" ou "mousedown".

La valeur par défaut est "mouseup" sur Windows, et "mousedown" sur macOS et Linux. 'affectation à Windows n'a aucun effet - le paramètre est uniquement conçu pour permettre l'ouverture du menu contextuel sur mouseup au lieu de mousedown, pas l'inverse.

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

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

Exemples
--------

Réglez le paramètre sur "mouseup":


```js
function logResult(result) {
  console.log(`Setting was modified: ${result}`);
}

browser.browserSettings.contextMenuShowEvent
  .set({ value: "mouseup" })
  .then(logResult);
```
browserSettings.imageAnimationBehavior
======================================

Un objet `BrowserSetting` qui peut être utilisé pour modifier la façon dont le navigateur traite les images animées, telles que les GIF.

La valeur sous-jacente est une chaîne qui peut prendre l'une des trois valeurs suivantes:

* "normal": la valeur par défaut Jouer des images animées comme d'habitude.
* "none": n'anime pas les images du tout.
* "once": joue une fois l'animation.
Compatibilité des navigateurs
-----------------------------

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

Exemples
--------

Désactiver les images animées :


```js
browser.browserSettings.imageAnimationBehavior.set({ value: "none" });
```
browserSettings.allowPopupsForUserEvents
========================================

Un objet `BrowserSetting` qui peut etre utilisé pour activer ou désactiver la capacité des pages web d'ouvrir des popups en réponse aux actions de l'utilisateur.

La valeur sous-jacente est un booléen.

Par défaut, les navigateurs permettent aux pages Web d'ouvrir des fenêtres contextuelles en réponse à un ensemble particulier d'événements : par exemple click, mouseup, submit. Si `allowPopupsForUserEvents` est défini sur `false`, aucun événement utilisateur ne pourra ouvrir des fenêtres contextuelles. Si elle est définie sur `true`, l'ensemble d'événements par défaut sera autorisé à ouvrir des fenêtres contextuelles.

Par exemple, supposons qu'une page web comporte un code comme celui-ci :


```js
window.addEventListener("click", (e) => {
  window.open("https://example.com", "myPopup", "height=400,width=400");
});
```


Par défaut, cela ouvrira une fenêtre contextuelle. Si vos extensions définient `allowPopupsForUserEvents` à `false`, cela n'ouvrira pas la fenêtre contextuelle, et l'utilisateur sera informé que le popup était bloqué.

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

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

Exemples
--------

Basculer le réglage :


```js
function toggleAllowPopup() {
  function toggle(current) {
    console.log(`Current value: ${current.value}`);
    browser.browserSettings.allowPopupsForUserEvents.set({
      value: !current.value,
    });
  }

  browser.browserSettings.allowPopupsForUserEvents.get({}).then(toggle);
}

browser.browserAction.onClicked.addListener(() => {
  toggleAllowPopup();
});
```
cookies.getAllCookieStores()
============================

La méthode **`getAllCookieStores()`** de l'API `cookies` retourne une liste de tous les cookies stores.

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

Syntaxe
-------


```js
var gettingStores = browser.cookies.getAllCookieStores();
```

### Paramètres

Aucun.

### Valeur renvoyée

Une `Promise` qui sera remplie avec un `tableau` d'objets `cookies.CookieStore` représentant tous les cookies stores existants.

Compatibibilité du navigateur
-----------------------------

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

Exemples
--------

Dans l'extrait suivant, la méthode `getAllCookieStores()` permet de récupérer tous les cookies stores actuellement disponible dans le navigateur et d'afficher chaque ID de cookie et les onglets qui partagent actuellement chaque cookie store.


```js
function logStores(cookieStores) {
  for (let store of cookieStores) {
    console.log(`Cookie store: ${store.id}\n Tab IDs: ${store.tabIds}`);
  }
}

var getting = browser.cookies.getAllCookieStores();
getting.then(logStores);
```


Chaque membre du tableau `cookieStores` est un objet `cookies.CookieStore`.

**Note :**

Cette API est basée sur l'API Chromium `chrome.cookies`. Cette documentation est dérivée de `cookies.json` dans le code 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.
cookies.SameSiteStatus
======================

Le type `SameSiteStatus` de l'API `cookies` représente des informations sur l'état `SameSite` d'un cookie.

Type
----

Les valeurs de ce type sont des chaînes de caractères. Les valeurs possibles sont :

`no_restriction`

Représente un ensemble de cookies sans attribut `SameSite`.

`lax`

Correspond au `SameSite=Lax`

`strict`

Correspond à un ensemble de témoins avec `SameSite=Strict`

Voir les cookies HTTP pour plus d'informations.
cookies.remove()
================

La méthode **`remove()`** de l'API `cookies` supprime un cookie, compte tenu de son nom et de son URL.

L'appel réussit uniquement si vous incluez la permission de l'API "cookies" dans votre fichier manifest.json, ainsi que les permissions d'hôte pour l'URL indiquée dans son manifest.

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

Syntaxe
-------


```js
var removing = browser.cookies.remove(
  details, // object
);
```

### Paramètres

`details`

Un `objet` contenant des informations permettant d'identifier le cookie à supprimer. Il contient les propriétés suivantes :

`firstPartyDomain`Facultatif

Une `chaîne` représentant le domaine de première partie avec lequel le cookie sera associé. Cette propriété doit être fournie si l'isolation de la première partie est activée sur le navigateur. Voir Isolement de la première partie.

`name`

Une `chaîne` représenant le nom du cookie à supprimer.

`storeId`Facultatif

Une `chaîne` représentant l'ID du cookie store pour trouver le cookie. Si elle n'est pas spécifiée, le cookie est recherché par défaut dans le cookie store du contexte d'exécution actuel.

`url`

Une `chaîne` représentant l'URL associée au cookie. Si l'extension n'a pas de permissions d'hôte pour cette URL, l'appel de l'API échouera.


### Valeur retournée

Une `Promise` qui sera remplie avec un objet `cookies.Cookie` contenant des détails sur le cookie qui a été supprimé. Si un cookie correspondant au paramètre `details` n'a pas pu être trouvé, la promesse est remplie avec `null`. Si l'appel échoue pour une raison quelconque, 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
--------

Cet exemple tente de supprimer le cookie nommé "favourite-colour", dont l'URL correspond à l'URL du document hébergé par l'onglet actuellement actif :


```js
function onRemoved(cookie) {
  console.log(`Removed: ${cookie}`);
}

function onError(error) {
  console.log(`Error removing cookie: ${error}`);
}

function removeCookie(tabs) {
  var removing = browser.cookies.remove({
    url: tabs[0].url,
    name: "favourite-colour",
  });
  removing.then(onRemoved, onError);
}

var getActive = browser.tabs.query({ active: true, currentWindow: true });
getActive.then(removeCookie);
```

### Example extensions

* cookie-bg-picker

**Note :**

Cette API est basée sur l'API Chromium `chrome.cookies`. Cette documentation est dérivée de `cookies.json` dans le code 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.