action.getUserSettings()

Syntax

let userSettings = await browser.action.getUserSettings();

Parameter

Diese Funktion nimmt keine Parameter.

Rückgabewert

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

userSettings

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

isOnToolbar Optional

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

Beispiele

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

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

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

Browser-Kompatibilität