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
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:
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.