permissions.contains()
Überprüfen Sie, ob die Erweiterung die im angegebenen permissions.Permissions-Objekt aufgelisteten Berechtigungen hat.
Das Permissions-Argument kann entweder eine origins-Eigenschaft enthalten, die ein Array von Host-Berechtigungen ist, oder eine permissions-Eigenschaft, die ein Array von API-Berechtigungen ist, oder beides.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt. Das Promise wird mit true aufgelöst, wenn die Erweiterung alle angegebenen Berechtigungen hat. Bei Host-Berechtigungen wird angenommen, dass die Berechtigungen übereinstimmen, wenn die Berechtigungen der Erweiterung die in origins aufgelisteten Berechtigungen bereichsübereinstimmen.
Syntax
let getContains = browser.permissions.contains(
permissions // Permissions object
)
Parameter
permissions-
Ein
permissions.Permissions-Objekt.
Rückgabewert
Ein Promise, das mit true erfüllt wird, wenn die Erweiterung bereits alle im permissions-Argument aufgelisteten Berechtigungen hat, oder false andernfalls.
Beispiele
// Extension permissions are:
// "webRequest", "tabs", "*://*.mozilla.org/*"
let testPermissions1 = {
origins: ["*://mozilla.org/"],
permissions: ["tabs"],
};
const testResult1 = await browser.permissions.contains(testPermissions1);
console.log(testResult1); // true
let testPermissions2 = {
origins: ["*://mozilla.org/"],
permissions: ["tabs", "alarms"],
};
const testResult2 = await browser.permissions.contains(testPermissions2);
console.log(testResult2); // false, "alarms" doesn't match
let testPermissions3 = {
origins: ["https://big.rakal.top/"],
permissions: ["tabs", "webRequest"],
};
const testResult3 = await browser.permissions.contains(testPermissions3);
console.log(testResult3); // true: "https://big.rakal.top/", matches: "*://*.mozilla.org/*"
let testPermissions4 = {
origins: ["https://example.org/"],
};
const testResult4 = await browser.permissions.contains(testPermissions4);
console.log(testResult4); // false: "https://example.org/", `origins` doesn't match
Beispielerweiterungen
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.permissions API von Chromium.