Cette page a été traduite par l'API Cloud Translation.

chrome.privacy

Description

Utilisez l'API chrome.privacy pour contrôler l'utilisation des fonctionnalités de Chrome qui peuvent affecter la confidentialité des utilisateurs. Cette API s'appuie sur le prototype ChromeSetting du type d'API pour obtenir et définir la configuration de Chrome.

Autorisations

privacy

Pour utiliser l'API, vous devez déclarer cette autorisation dans le fichier manifeste de votre extension. Exemple :

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

Concepts et utilisation

La lecture de la valeur actuelle d'un paramètre Chrome est simple. Vous devez d'abord trouver la propriété qui vous intéresse, puis appeler get() sur cet objet afin de récupérer sa valeur actuelle et le niveau de contrôle de votre extension. Par exemple, pour déterminer si la fonctionnalité de saisie automatique des cartes de crédit de Chrome est activée, vous devez écrire:

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.value) {
    console.log('Autofill is on!');
  } else {
    console.log('Autofill is off!');
  }
});

La modification de la valeur d'un paramètre est un peu plus complexe, car vous devez d'abord vérifier que votre extension peut contrôler le paramètre. L'utilisateur ne verra aucune modification de ses paramètres si votre extension active un paramètre verrouillé sur une valeur spécifique par les règles d'entreprise (levelOfControl sera défini sur "not_controllable") ou si une autre extension contrôle la valeur (levelOfControl sera défini sur "control_by_other_extensions"). L'appel set() aboutit, mais le paramètre est immédiatement remplacé. Comme cela peut prêter à confusion, il est conseillé d'avertir l'utilisateur lorsque les paramètres qu'il a choisis ne sont pas concrètement appliqués.

Remarque:Pour en savoir plus sur la capacité des extensions à contrôler les ChromeSetting, consultez chrome.types.ChromeSetting.

Cela signifie que vous devez utiliser la méthode get() pour déterminer votre niveau d'accès, puis n'appeler set() que si votre extension peut contrôler le paramètre (en fait, si votre extension ne peut pas contrôler le paramètre, il est probablement judicieux de désactiver visuellement la fonctionnalité pour limiter la confusion chez les utilisateurs):

chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
      if (chrome.runtime.lastError === undefined) {
        console.log("Hooray, it worked!");
      } else {
        console.log("Sadness!", chrome.runtime.lastError);
      }
    });
  }
});

Si vous souhaitez apporter des modifications à la valeur d'un paramètre, ajoutez un écouteur à son événement onChange. Entre autres utilisations, cela vous permettra d'avertir l'utilisateur si une extension plus récente prend le contrôle d'un paramètre ou si une règle d'entreprise remplace votre contrôle. Pour écouter les modifications de l'état de saisie automatique d'une carte de crédit, par exemple, le code suivant suffit:

chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
  function (details) {
    // The new value is stored in `details.value`, the new level of control
    // in `details.levelOfControl`, and `details.incognitoSpecific` will be
    // `true` if the value is specific to Incognito mode.
  }
);

Exemples

Pour essayer cette API, installez l'exemple d'API de confidentialité à partir du dépôt chrome-extension-samples.

Types

IPHandlingPolicy

Chrome 48 ou version ultérieure

Règle de gestion des adresses IP de WebRTC.

Enum

"default"

"default_public_and_private_interfaces"

"default_public_interface_only"

"disable_non_proxied_udp"

Propriétés

network

Paramètres qui influencent la façon dont Chrome gère les connexions réseau en général.

Type

objet

Propriétés

networkPredictionEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome tente d'accélérer votre navigation sur le Web en résolvant à l'avance les entrées DNS et en ouvrant de manière préventive les connexions TCP et SSL aux serveurs. Cette préférence ne concerne que les actions effectuées par le service de prédiction interne de Chrome. Cela n'affecte pas les préfectures ou les préconnexions déclenchées sur une page Web. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
webRTCIPHandlingPolicy

types.ChromeSetting<IPHandlingPolicy>

Chrome 48 ou version ultérieure

Autorisez les utilisateurs à spécifier les compromis performances/confidentialité des contenus multimédias qui affectent la manière dont le trafic WebRTC sera acheminé et la quantité d'informations sur les adresses locales exposées. La valeur de cette préférence est de type IPHandlingPolicy et est définie par défaut sur default.

services

Paramètres permettant d'activer ou de désactiver des fonctionnalités nécessitant des services réseau tiers fournis par Google et votre moteur de recherche par défaut.

Type

objet

Propriétés

alternateErrorPagesEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome utilise un service Web pour résoudre les erreurs de navigation. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
autofillAddressEnabled

types.ChromeSetting<boolean>

Chrome 70 et versions ultérieures

Si cette option est activée, Chrome propose de renseigner automatiquement les adresses et d'autres données de formulaire. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
autofillCreditCardEnabled

types.ChromeSetting<boolean>

Chrome 70 et versions ultérieures

Si cette option est activée, Chrome propose de remplir automatiquement les formulaires de carte de crédit. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
autofillEnabled

types.ChromeSetting<boolean>

Obsolète depuis Chrome 70

Veuillez utiliser privacy.services.autofillAddressEnabled et privacy.services.autofillCreditCardEnabled. Cette fonctionnalité est conservée pour assurer la rétrocompatibilité dans cette version et sera supprimée à l'avenir.
Si cette option est activée, Chrome propose de remplir automatiquement les formulaires. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
passwordSavingEnabled

types.ChromeSetting<boolean>

Si cette option est activée, le gestionnaire de mots de passe vous demandera si vous souhaitez enregistrer les mots de passe. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
safeBrowsingEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome met tout en œuvre pour vous protéger contre l'hameçonnage et les logiciels malveillants. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
safeBrowsingExtendedReportingEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome envoie des informations supplémentaires à Google lorsque la navigation sécurisée bloque une page, comme son contenu. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur false.
searchSuggestEnabled

types.ChromeSetting<boolean>

Lorsque cette option est activée, Chrome envoie le texte que vous saisissez dans l'omnibox à votre moteur de recherche par défaut, qui fournit des prédictions de sites Web et de recherches susceptibles de compléter votre saisie. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.
spellingServiceEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome utilise un service Web pour corriger les fautes d'orthographe. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur false.
translationServiceEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome vous propose de traduire les pages qui sont écrites dans une langue que vous ne comprenez pas. La valeur de cette préférence est une valeur booléenne et est définie par défaut sur true.

websites

Paramètres qui déterminent les informations mises à la disposition des sites Web par Chrome.

Type

objet

Propriétés

adMeasurementEnabled

types.ChromeSetting<boolean>

Chrome 111 et versions ultérieures

Si cette option est désactivée, l'API Attribution Reporting et l'API Private Aggregation sont désactivées. La valeur de cette préférence est de type booléen. La valeur par défaut est true. Les extensions ne peuvent désactiver ces API qu'en définissant la valeur sur false. Si vous essayez de définir ces API sur true, une erreur est générée.
doNotTrackEnabled

types.ChromeSetting<boolean>

Chrome 65 ou version ultérieure

Si cette option est activée, Chrome envoie l'en-tête "Do Not Track" (DNT: 1) avec vos requêtes. La valeur de cette préférence est de type booléen. La valeur par défaut est false.
fledgeEnabled

types.ChromeSetting<boolean>

Chrome 111 et versions ultérieures

Si cette option est désactivée, l'API Fledge l'est également. La valeur de cette préférence est de type booléen. La valeur par défaut est true. Les extensions ne peuvent désactiver cette API qu'en définissant la valeur sur false. Si vous essayez de définir cette API sur true, une erreur est générée.
hyperlinkAuditingEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome envoie des pings d'audit lorsqu'un site Web le demande (<a ping>). La valeur de cette préférence est de type booléen, et la valeur par défaut est true.
protectedContentEnabled

types.ChromeSetting<boolean>

Disponible sur Windows et ChromeOS uniquement: si cette option est activée, Chrome fournit un ID unique aux plug-ins afin qu'ils puissent exécuter le contenu protégé. La valeur de cette préférence est de type booléen. La valeur par défaut est true.
referrersEnabled

types.ChromeSetting<boolean>

Si cette option est activée, Chrome envoie des en-têtes referer avec vos requêtes. Oui, le nom de cette préférence ne correspond pas à l'en-tête mal orthographié. Non, nous n'allons pas la modifier. La valeur de cette préférence est de type booléen. La valeur par défaut est true.
relatedWebsiteSetsEnabled

types.ChromeSetting<boolean>

Chrome 121 et versions ultérieures

Si cette option est désactivée, Ensembles de sites Web associés l'est également. La valeur de cette préférence est de type booléen. La valeur par défaut est true. Les extensions ne peuvent désactiver cette API qu'en définissant la valeur sur false. Si vous essayez de définir cette API sur true, une erreur est générée.
thirdPartyCookiesAllowed

types.ChromeSetting<boolean>

Si cette option est désactivée, Chrome empêche les sites tiers de définir des cookies. La valeur de cette préférence est de type booléen. La valeur par défaut est true.
topicsEnabled

types.ChromeSetting<boolean>

Chrome 111 et versions ultérieures

Si elle est désactivée, l'API Topics l'est également. La valeur de cette préférence est de type booléen. La valeur par défaut est true. Les extensions ne peuvent désactiver cette API qu'en définissant la valeur sur false. Si vous essayez de définir cette API sur true, une erreur est générée.