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

js
let getContains = browser.permissions.contains(
  permissions                // Permissions object
)

Parameter

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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
contains

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Beispiele

js
// 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.