PushManager: permissionState() Methode

Baseline 2023
Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

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

Die permissionState() Methode der PushManager Schnittstelle gibt ein Promise zurück, das sich zu einem String auflöst, der den Berechtigungsstatus des Push-Managers angibt. Mögliche Werte sind 'prompt', 'denied' oder 'granted'.

Hinweis: Seit Firefox 44 wurden die Berechtigungen für Benachrichtigungen und Push zusammengeführt. Wenn die Berechtigung für Benachrichtigungen erteilt wird, wird auch Push aktiviert.

Syntax

js
permissionState()
permissionState(options)

Parameter

options Optional

Ein Objekt, das optionale Konfigurationsparameter enthält. Es kann die folgenden Eigenschaften haben:

userVisibleOnly

Ein boolescher Wert, der angibt, dass das zurückgegebene Push-Abonnement nur für Nachrichten verwendet wird, deren Effekt dem Benutzer sichtbar gemacht wird.

applicationServerKey

Ein öffentlicher Schlüssel, den Ihr Push-Server verwenden wird, um Nachrichten über einen Push-Server an Client-Apps zu senden. Dieser Wert ist Teil eines Schlüsselpaares zur Signatur, das von Ihrem Anwendungsserver generiert wurde und mit elliptischer Kurven-Digitalsignatur (ECDSA) über die P-256-Kurve verwendbar ist.

Rückgabewert

Ein Promise, das sich zu einem String mit einem Wert von 'prompt', 'denied' oder 'granted' auflöst.

Spezifikationen

Specification
Push API
# dom-pushmanager-permissionstate

Browser-Kompatibilität