Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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

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://newreal1.mobosoft.fun/"],
  permissions: ["tabs", "webRequest"],
};

const testResult3 = await browser.permissions.contains(testPermissions3);
console.log(testResult3); // true: "https://newreal1.mobosoft.fun/", 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

Hinweis: Diese API basiert auf der chrome.permissions API von Chromium.