management.setEnabled()

Aktiviert oder deaktiviert das angegebene Add-on.

Diese Funktion muss normalerweise im Kontext einer Benutzeraktion aufgerufen werden, beispielsweise im Klick-Handler für einen Button. Der Browser kann den Benutzer auch bitten, die Änderung zu bestätigen.

Diese API erfordert die "management"-API-Berechtigung.

Es handelt sich um eine asynchrone Funktion, die ein Promise zurückgibt.

Die Funktion ermöglicht das Aktivieren/Deaktivieren von Theme-Addons, wird jedoch einen Fehler zurückgeben, wenn sie zum Aktivieren oder Deaktivieren anderer Arten von Web-Erweiterungen verwendet wird.

Syntax

js
let settingEnabled = browser.management.setEnabled(
  id,              // string
  enabled         // boolean
)

Parameter

id

string. ID des Add-ons, das aktiviert/deaktiviert werden soll.

enabled

boolean. Gibt an, ob das Add-on aktiviert oder deaktiviert werden soll.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das Add-on deaktiviert oder aktiviert wurde.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Aktivieren/Deaktivieren des Add-ons mit der ID "my-add-on":

js
let id = "my-add-on";

function toggleEnabled(id) {
  let getting = browser.management.get(id);
  getting.then((info) => {
    browser.management.setEnabled(id, !info.enabled);
  });
}

toggleEnabled(id);

Beispiel-Erweiterungen

Hinweis: Diese API basiert auf der chrome.management-API von Chromium. Diese Dokumentation ist abgeleitet von management.json im Chromium-Code.