get()

Die Methode BrowserSetting.get() ruft den aktuellen Wert der Browsereinstellung und eine Aufzählung ab, die angibt, wie der Wert der Einstellung derzeit gesteuert wird.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let getting = setting.get(
  details     // object
)

Parameter

details

Ein leeres Objekt.

Rückgabewert

Ein Promise, das mit einem Objekt erfüllt wird, das die folgenden Eigenschaften enthält:

value

Der Wert der Einstellung. Der Typ dieser Eigenschaft wird durch die jeweilige Einstellung bestimmt.

levelOfControl

string. Dies stellt dar, wie die Einstellung derzeit gesteuert wird. Sie können es verwenden, um zu prüfen, ob Sie die Einstellung ändern können. Details dazu finden Sie unter BrowserSetting.set(). Sein Wert kann einer der folgenden sein:

"not_controllable" Erweiterungen dürfen diese Einstellung nicht ändern.
"controlled_by_other_extensions" Eine andere Erweiterung, die nach dieser installiert wurde, hat diese Einstellung geändert.
"controllable_by_this_extension" Diese Erweiterung darf die Einstellung ändern.
"controlled_by_this_extension" Diese Erweiterung hat die Einstellung bereits geändert.

Browser-Kompatibilität

Beispiel

Protokollieren Sie den Wert und das Kontrollniveau der Eigenschaft networkPredictionEnabled des Objekts privacy.network, für private Browserfenster. Beachten Sie, dass dazu die Berechtigung "privacy" des Browsers erforderlich ist.

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

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

Hinweis: Diese API basiert auf der chrome.types API von Chromium.