permissions.contains()
Überprüfen Sie, ob die Erweiterung die im angegebenen permissions.Permissions
Objekt aufgeführten Berechtigungen besitzt.
Das Permissions
Argument kann entweder eine origins
Eigenschaft, die ein Array von Host-Berechtigungen ist, oder eine permissions
Eigenschaft, die ein Array von API-Berechtigungen ist, oder beide enthalten.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt. Das Promise löst sich zu true
auf, wenn die Erweiterung über alle angegebenen Berechtigungen verfügt. Bei Host-Berechtigungen werden die Berechtigungen als übereinstimmend betrachtet, wenn die Berechtigungen der Erweiterung mit den in origins
aufgelisteten Berechtigungen musterü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 aufgeführten Berechtigungen hat, oder false
andernfalls.
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
contains |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
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://developer.mozilla.org/"],
permissions: ["tabs", "webRequest"],
};
const testResult3 = await browser.permissions.contains(testPermissions3);
console.log(testResult3); // true: "https://developer.mozilla.org/", 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
Hinweis:
Diese API basiert auf der chrome.permissions
API von Chromium.