privacy.websites
================

La propriété `privacy.websites` contient les paramètres liés à la vie privée qui contrôlent la façon dont le navigateur interargit avec les sites web. Chaque propriété est un objet `types.BrowserSetting`.

Les valeurs par défaut de ces propriétés ont tendance à varier selon les navigateurs.

Propriétés
----------

`cookieConfig`

Un objet `types.BrowserSetting` dont la valeur sous-jacente est un objet.

L'objet a deux propriétés :

* `behavior`: une chaîne qui peut prendre l'une des valeurs suivantes:
    + "allow\_all": accepte tous les cookies
    + "reject\_all": rejeter tous les cookies
    + "reject\_third\_party": rejeter tous les cookies tiers
    + "allow\_visited" : accepte un cookie tiers uniquement si le domaine de premier niveau du cookie contient déjà au moins un cookie.
    + "reject\_trackers": rejeter les cookies de suivi
* `nonPersistentCookies`: un booléen. Si la valeur est true, tous les cookies seront traités comme des cookies de session.

`firstPartyIsolate`

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

SI `true`, la préférence `firstPartyIsolate` permet au navigateur d'associer toutes les données (y compris les cookies, les données HSTS, les images mises en cache, etc.) pour tous les domaines tiers avec le domaine dans la barre d'adresse. Cela empêche les suiveurs tiers d'utiliser directement les informations stockées pour identifier l'utilisateur sur différents sites Web, mais peut interrompre les sites Web dans lesquels l'utilisateur se connecte avec un compte tiers (tel qu'un compte Facebook ou Google).

Par défaut à `false`.

`hyperlinkAuditingEnabled`

Un objet `types.BrowserSetting` dont la valeur sous-jacente est un booléen. Si `true`, le navigateur envoie des pings d'audit lorsqu'un site web utilise l'attribut `ping` pour les demander.

`protectedContentEnabled`

Un objet `types.BrowserSetting` dont la valeur sous-jacente est un booléen. Disponible uniquement sur Windows. Si `true`, le navigateur fournit un ID unique aux plugins afin d'exécuter le contenu protégé.

`referrersEnabled`

Un objet `types.BrowserSetting` dont la valeur sous-jacente est un booléen. Si activé, le navigateur envoie les en-têtes de référence avec vos demandes.

`resistFingerprinting`

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

Les empreintes digitales des navigateurs sont la pratique par laquelle les sites Web utilisent les API Web pour collecter des données d'état ou de configuration associées au navigateur ou à l'appareil sur lequel il s'exécute. En faisant cela, ils peuvent construire une empreinte numérique qu'ils peuvent utiliser pour identifier et suivre un utilisateur particulier.

Si `true`, la préférence `resistFingerprinting` signale au navigateur des informations usurpées génériques pour les données couramment utilisées pour les empreintes digitales. Ces données incluent le nombre de cœurs de processeur, la précision des temporisateurs JavaScript et le fuseau horaire local. Il désactive également les fonctionnalités utilisées pour la prise d'empreintes digitales, telles que la prise en charge de GamePad et les API WebSpeech et Navigator.

Par défaut à `false`.

`thirdPartyCookiesAllowed`

Un objet `types.BrowserSetting` dont la valeur sous-jacente est un booléen. Si `false`, le navigateur bloque les cookies tiers.

`trackingProtectionMode`

La "protection de suivi" est une fonctionnalité de navigateur qui bloque les requêtes faites sur des domaines qui sont connus pour s'engager dans le suivi multi-sites des utilisateurs. Les sites qui suivent les utilisateurs sont généralement des sites publicitaires et analytiques tiers. Ce paramètre est un objet `types.BrowserSetting` qui détermine si le navigateur doit activer la protection de suivi. Sa valeur sous-jacente est une chaîne qui peut prendre l'une des trois valeurs :

* `"always"`: La protection de suivi est activée.
* `"never"`: La protection de suivi est désactivée.
* `"private_browsing"`: La protection de suivi est activée uniquement dans les fenêtres de navigation privée.

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

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

Exemples
--------

Définissez la propriété `hyperlinkAuditingEnabled` .


```js
function onSet(result) {
  if (result) {
    console.log("success");
  } else {
    console.log("failure");
  }
}

browser.browserAction.onClicked.addListener(() => {
  var getting = browser.privacy.websites.hyperlinkAuditingEnabled.get({});
  getting.then((got) => {
    console.log(got.value);
    if (
      got.levelOfControl === "controlled\_by\_this\_extension" ||
      got.levelOfControl === "controllable\_by\_this\_extension"
    ) {
      var setting = browser.privacy.websites.hyperlinkAuditingEnabled.set({
        value: true,
      });
      setting.then(onSet);
    } else {
      console.log("Not able to set hyperlinkAuditingEnabled");
    }
  });
});
```


**Note :**

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