action.getUserSettings()

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

Hinweis: Diese API ist in Manifest V3 oder höher verfügbar.

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

Syntax

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

Parameter

Diese Funktion erfordert keine Parameter.

Rückgabewert

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

userSettings

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

isOnToolbar Optional

boolean. Gibt an, ob der Benutzer das Symbol der Aktion in der Browser-Benutzeroberflä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 Browser-Benutzeroberfläche ab.

Beispiele

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

js
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

BCD tables only load in the browser

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