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