browserAction.getUserSettings()

Ruft die vom Benutzer angegebenen Einstellungen für die Browser-Aktion ab.

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

Syntax

js
let userSettings = await browser.browserAction.getUserSettings();

Parameter

Diese Funktion nimmt keine Parameter entgegen.

Rückgabewert

Ein Promise, das mit einem Objekt erfüllt wird, das folgende Eigenschaften hat:

userSettings

Ein Objekt, das die vom Benutzer angegebenen Einstellungen für die Browser-Aktion enthält mit diesen Eigenschaften:

isOnToolbar Optional

boolean. Ob der Benutzer das Symbol der Aktion an die Browser-Oberfläche angeheftet hat. Diese Einstellung gibt nicht an, ob das Aktionssymbol sichtbar ist. Die Sichtbarkeit des Symbols hängt von der Größe des Browserfensters und dem Layout der Browser-Oberfläche ab.

Beispiele

Dieser Code protokolliert eine Nachricht, die angibt, ob die Browser-Aktion angeheftet ist oder nicht:

js
function gotSettings(userSettings) {
  if (userSettings.isOnToolbar) {
    console.log("Browser action is pinned to toolbar.");
  } else {
    console.log("Browser action is not pinned to toolbar.");
  }
}

let gettingUserSettings = browser.browserAction.getUserSettings();
gettingUserSettings.then(gotSettings);

Browser-Kompatibilität

BCD tables only load in the browser