action.getUserSettings()
Ruft die vom Benutzer spezifizierten 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
let userSettings = await browser.action.getUserSettings();
Parameter
Diese Funktion nimmt keine Parameter.
Rückgabewert
Ein Promise
, das mit einem Objekt erfüllt wird, welches folgende Eigenschaften hat:
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 an die Browser-Oberflä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-Oberfläche ab.
Beispiele
Dieser Code gibt eine Meldung aus, die anzeigt, 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
Hinweis:
Diese API basiert auf Chromiums chrome.action
API.