PushSubscriptionOptions

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 PushSubscriptionOptions-Schnittstelle der Push-API repräsentiert die mit einem Push-Abonnement verbundenen Optionen.

Das schreibgeschützte PushSubscriptionOptions-Objekt wird zurückgegeben, indem PushSubscription.options auf einem PushSubscription aufgerufen wird. Diese Schnittstelle hat keinen eigenen Konstruktor.

Instanzeigenschaften

PushSubscriptionOptions.userVisibleOnly Schreibgeschützt

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

PushSubscriptionOptions.applicationServerKey Schreibgeschützt

Ein öffentlicher Schlüssel, den Ihr Push-Server verwenden wird, um Nachrichten über einen Push-Server an Client-Apps zu senden.

Beispiele

Der Aufruf von PushSubscription.options auf einem PushSubscription gibt ein PushSubscriptionOptions-Objekt zurück. Im untenstehenden Beispiel wird dieses in die Konsole geschrieben.

js
navigator.serviceWorker.ready.then((reg) => {
  reg.pushManager.getSubscription().then((subscription) => {
    const options = subscription.options;
    console.log(options); // a PushSubscriptionOptions object
  });
});

Spezifikationen

Specification
Push API
# dom-pushsubscriptionoptions

Browser-Kompatibilität

BCD tables only load in the browser