PushSubscription: endpoint-Eigenschaft

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: Dieses Feature ist verfügbar in Web Workers.

Die schreibgeschützte endpoint-Eigenschaft des PushSubscription-Interfaces gibt einen String zurück, der den mit dem Push-Abonnement verbundenen Endpunkt enthält.

Der Endpunkt hat die Form einer benutzerdefinierten URL, die auf einen Push-Server zeigt. Diese kann verwendet werden, um eine Push-Nachricht an die bestimmte Service-Worker-Instanz zu senden, die den Push-Dienst abonniert hat. Aus diesem Grund ist es ratsam, Ihren Endpunkt geheim zu halten, damit andere ihn nicht kapern und die Push-Funktionalität missbrauchen.

Wert

Ein String.

Beispiele

js
navigator.serviceWorker.ready.then((reg) => {
  reg.pushManager.subscribe({ userVisibleOnly: true }).then((subscription) => {
    console.log(subscription.endpoint);

    // At this point you would most likely send the subscription
    // endpoint to your server, save it, then use it to send a
    // push message at a later date
  });
});

Spezifikationen

Specification
Push API
# dom-pushsubscription-endpoint

Browser-Kompatibilität

BCD tables only load in the browser