Fordert den Benutzer auf, die impermissions.Permissions-Objekt aufgeführten Berechtigungen zu erteilen.

DasPermissions-Argument kann eineorigins-Eigenschaft enthalten, ein Array vonHost-Berechtigungen, einepermissions-Eigenschaft, ein Array vonAPI-Berechtigungen, oder beides.

Angeforderte Berechtigungen müssen imoptional_permissions manifest.json-Schlüssel definiert sein. Dieorigins-Eigenschaft kann Berechtigungen enthalten, die mit einer Teilmenge der Hosts übereinstimmen, die durch eine optionale Berechtigung abgedeckt sind. Zum Beispiel, wennoptional_permissions"*://mozilla.org/" enthalten, dann kannpermissions.origins"https://developer.mozilla.org/" enthalten.

Anfragen fürnur-optionale Berechtigungen können keine anderen optionalen Berechtigungen beinhalten.

Die Anfrage kann nur innerhalb des Handlers für eineBenutzeraktion gestellt werden. Wenn nicht alle angeforderten Berechtigungen stillschweigend gewährt werden, fragt der Browser den Benutzer, ob die angeforderten Berechtigungen gewährt werden sollen. Eine Anfrage wird für alle angeforderten Berechtigungen gestellt: Entweder werden alle Berechtigungen gewährt oder keine.

Die Erweiterung behält alle gewährten Berechtigungen bei, selbst über Updates und Deaktivierungs- und Aktivierungszyklen hinweg.

Dies ist eine asynchrone Funktion, die einPromise zurückgibt.

Syntax

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

Parameter

permissions

Einpermissions.Permissions-Objekt.

Rückgabewert

EinPromise, das mittrue erfüllt wird, wenn der Erweiterung die impermissions-Argument aufgeführten Berechtigungen gewährt wurden, oder andernfallsfalse.

Beispiele

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

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

• dnr-dynamic-with-options
• dnr-redirect-url
• permissions
• userScripts-mv3

Browser-Kompatibilität