Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

get()

La méthode BrowserSetting.get() obtient la valeur actuelle du paramètre du navigateur et une énumération indiquant comment la valeur du paramètre est actuellement controléee..

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

Syntaxe

js
var getting = setting.get(
  details, // object
);

Paramètres

détails

Un objet vide.

Valeur de retour

Une Promise qui sera remplie avec un objet avec les propriétés suivantes :

value

La valeur du paramètre. Le type de cette propriété est déterminé par le paramètre particulier.

levelOfControl

string. Cela représente la façon dont la paramètre est actuellement controllé. Vous pouvez l'utiliser pour vérifier si vous pouvez modifier le paramètre. Voir BrowserSetting.set() pour plus détails. Sa valeur peut-être l'une des suivantes :

"not_controllable" Les extensions ne sont pas autorisées à modifier le paramètre.
"controlled_by_other_extensions" Une autre extension qui a été installée après celle-ci a modifié ce paramètre
"controllable_by_this_extension" Cette extension est autorisée à modifier le paramètre.
"controlled_by_this_extension" Cette extensions a déjà modifi le paramètre.

Compatibilité des navigateurs

Voir types.BrowserSetting.

Exemple

Enregitrez la valeur et le niveau de contrôle de la propriété networkPredictionEnabled de l'objet privacy.network, pour les fenêtres de navigations privées. Notez que cela nécessite la permission du navigateur "privacy".

js
var getting = browser.privacy.network.networkPredictionEnabled.get({});

getting.then((got) => {
  console.log(`Value: ${got.value}`);
  console.log(`Control: ${got.levelOfControl}`);
});

Note :

Cette API est basée sur l'API Chromium chrome.types.