Berechtigungen: `revoke()`-Methode

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die revoke()-Methode der Permissions-Schnittstelle setzt eine aktuell festgelegte Berechtigung zurück auf ihren Standardzustand, der normalerweise prompt ist. Diese Methode wird auf dem globalen Permissions-Objekt navigator.permissions aufgerufen.

Diese Methode wurde aus der Hauptspezifikation der Berechtigungen-API entfernt, da der Anwendungsfall unklar ist. Berechtigungen werden durch den Browser verwaltet und das aktuelle Berechtigungsmodell sieht nicht vor, dass der Website-Entwickler Berechtigungen ausdrücklich anfordern oder widerrufen kann. Browser haben diese API hinter Präferenzen eingeführt, aber es ist unwahrscheinlich, dass sie den Standardweg erreicht. Für weitere Informationen siehe die ursprüngliche Diskussion über die 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 Berechtigungsart 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 einem TypeError ablehnen, wenn der Berechtigungsname vom Browser nicht unterstützt wird.

Für die push Berechtigungen können Sie auch angeben:

userVisibleOnly Optional: (Nur Push, nicht unterstützt in Firefox — siehe den Abschnitt Browser-Unterstützung unten) Gibt an, ob Sie für jede Nachricht eine Benachrichtigung anzeigen oder stille Push-Benachrichtigungen senden möchten. Der Standardwert ist false.

Für die midi Berechtigung können Sie auch angeben:

sysex Optional: Gibt an, ob Sie System-Exklusivnachrichten benötigen und/oder empfangen. Der Standardwert ist false.

Rückgabewert

Ein Promise, das seinen Fulfillment-Handler mit einem PermissionStatus-Objekt aufruft, das das Ergebnis der Anfrage anzeigt.

Ausnahmen

TypeError: Der Abruf der PermissionDescriptor-Informationen ist auf irgendeine Weise fehlgeschlagen, oder die Berechtigung existiert nicht oder wird momentan nicht unterstützt (z.B. midi oder push mit userVisibleOnly).

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