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

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.