permissions.request()

Fragt den Benutzer nach den in dem permissions.Permissions Objekt aufgelisteten Berechtigungen.

Das Permissions-Argument kann eine origins-Eigenschaft enthalten, ein Array von Host-Berechtigungen, eine permissions-Eigenschaft, ein Array von API-Berechtigungen, oder beides.

Angeforderte Berechtigungen müssen im optional_permissions Schlüssel der manifest.json definiert sein. Die origins-Eigenschaft kann Berechtigungen enthalten, die einem Teil der Hosts entsprechen, die durch eine optionale Berechtigung abgedeckt sind. Zum Beispiel, wenn optional_permissions "*://mozilla.org/" enthalten, dann kann permissions.origins "https://developer.mozilla.org/" enthalten.

Anfragen für nur optionale Berechtigungen dürfen keine anderen optionalen Berechtigungen enthalten.

Die Anfrage kann nur im Handler für eine Benutzeraktion gestellt werden. Es sei denn, alle angeforderten Berechtigungen werden leise gewährt, fragt der Browser den Benutzer, ob die angeforderten Berechtigungen gewährt werden sollen. Eine einzige Anfrage wird für alle angeforderten Berechtigungen gestellt: entweder werden alle Berechtigungen gewährt oder keine.

Die Erweiterung behält alle gewährten Berechtigungen, selbst bei Upgrade und Deaktivieren und erneutes Aktivieren.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let requesting = browser.permissions.request(
  permissions                // Permissions object
)

Parameter

Rückgabewert

Ein Promise, das mit true erfüllt wird, wenn der Erweiterung die im permissions Argument aufgelisteten Berechtigungen gewährt werden, oder false andernfalls.

Beispiele

Dieser Code fügt einen Klick-Handler hinzu, der nach verschiedenen Berechtigungen fragt, dann das Ergebnis der Anfrage und die Berechtigungen der Erweiterung nach Abschluss der Anfrage protokolliert.

js
const permissionsToRequest = {
  permissions: ["bookmarks", "history"],
  origins: ["https://developer.mozilla.org/"],
};

async function requestPermissions() {
  function onResponse(response) {
    if (response) {
      console.log("Permission was granted");
    } else {
      console.log("Permission was refused");
    }
    return browser.permissions.getAll();
  }

  const response = await browser.permissions.request(permissionsToRequest);
  const currentPermissions = await onResponse(response);

  console.log(`Current permissions:`, currentPermissions);
}

document
  .querySelector("#request")
  .addEventListener("click", requestPermissions);

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.permissions API.