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
let requesting = browser.permissions.request(
permissions // Permissions object
)
Parameter
permissions
-
Ein
permissions.Permissions
Objekt.
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.
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.