Permissions: revoke() Methode
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.
Die revoke()
Methode der Permissions
-Schnittstelle setzt eine derzeit gesetzte Berechtigung auf ihren Standardzustand zurück, der normalerweise prompt
ist.
Diese Methode wird auf dem globalen Permissions
-Objekt navigator.permissions
aufgerufen.
Diese Methode wurde aus der Hauptspezifikation der Berechtigungs-API entfernt, da der Anwendungsfall unklar ist.
Berechtigungen werden vom Browser verwaltet und das aktuelle Berechtigungsmodell sieht nicht vor, dass der Website-Entwickler Berechtigungen anfordern oder widerrufen kann. Browser haben diese API hinter Präferenzen implementiert, aber es ist unwahrscheinlich, dass sie den Standardisierungspfad erreicht.
Weitere Informationen finden Sie in der ursprünglichen Diskussion zur Entfernung von permissions.revoke()
.
Syntax
revoke(permissionDescriptor)
Parameter
permissionDescriptor
-
Ein Objekt, das Optionen für die
revoke
-Operation festlegt. Die verfügbaren Optionen für diesen Deskriptor hängen von der Art der Berechtigung ab.Alle Berechtigungen haben einen Namen:
name
-
Ein String, der den Namen der API enthält, deren Berechtigungen Sie abfragen möchten. Das zurückgegebene
Promise
wird mit einemTypeError
abgelehnt, wenn der Berechtigungsname vom Browser nicht unterstützt wird.
Für die
push
-Berechtigungen können Sie außerdem angeben:userVisibleOnly
Optional-
(Nur Push, nicht in Firefox unterstützt — siehe den Abschnitt zur Browser-Kompatibilität unten) Gibt an, ob Sie eine Benachrichtigung für jede Nachricht anzeigen oder stille Push-Benachrichtigungen senden möchten. Der Standardwert ist
false
.
Für die
midi
-Berechtigung können Sie außerdem angeben:sysex
Optional-
Gibt an, ob Sie systemexklusive Nachrichten benötigen und/oder empfangen. Der Standardwert ist
false
.
Rückgabewert
Ein Promise
, das seinen Erfüllungs-Handler mit einem PermissionStatus
-Objekt aufruft, das das Ergebnis der Anfrage anzeigt.
Ausnahmen
TypeError
-
Das Abrufen der
PermissionDescriptor
-Informationen ist auf irgendeine Weise fehlgeschlagen, oder die Berechtigung existiert nicht oder wird derzeit nicht unterstützt (z. B.midi
, oderpush
mituserVisibleOnly
).
Beispiele
Diese Funktion kann von einer App verwendet werden, um zu beantragen, dass ihre eigene Geolocation-API-Berechtigung widerrufen wird.
function revokePermission() {
navigator.permissions.revoke({ name: "geolocation" }).then((result) => {
report(result.state);
});
}
Spezifikationen
Specification |
---|
Relinquishing Permissions # dom-permissions-revoke |
Browser-Kompatibilität
BCD tables only load in the browser