management.getPermissionWarningsByManifest()

Wenn der Benutzer ein Add-on installiert oder aktualisiert, kann der Browser den Benutzer über besonders leistungsfähige Berechtigungen warnen, die das Add-on angefordert hat. Nicht alle Berechtigungen führen zu Warnungen, und dieses Verhalten ist nicht über alle Browser hinweg standardisiert.

Angesichts des Textes einer manifest.json-Datei gibt diese Funktion die Berechtigungswarnungen zurück, die für das resultierende Add-on ausgegeben würden, als ein Array von Zeichenfolgen.

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

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

Syntax

js
let gettingWarnings = browser.management.getPermissionWarningsByManifest(
  manifestString      // string
)

Parameter

manifestString

string. Zeichenfolge, die die Manifestdatei enthält. Dies muss ein gültiges Manifest sein: Es muss beispielsweise alle obligatorischen Manifest-Schlüssel enthalten.

Rückgabewert

Ein Promise, das mit einem Array von Zeichenfolgen erfüllt wird, von denen jede den Text einer Berechtigungswarnung enthält.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Protokollieren Sie die Berechtigungswarnungen für die gegebene Manifestdatei:

js
let manifest = {
  manifest_version: 2,
  name: "test",
  version: "1.0",
  permissions: ["management", "<all_urls>"],
};

let manifestString = JSON.stringify(manifest);

function gotWarnings(warnings) {
  console.log(warnings);
}

function gotError(error) {
  console.log(`Error: ${error}`);
}

let gettingWarnings =
  browser.management.getPermissionWarningsByManifest(manifestString);
gettingWarnings.then(gotWarnings, gotError);

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