PushSubscription: endpoint property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
The endpoint read-only property of the PushSubscription interface returns a string containing the endpoint associated with the push subscription.
The endpoint takes the form of a custom URL pointing to a push server, which can be used to send a push message to the particular service worker instance that subscribed to the push service. For this reason, it is a good idea to keep your endpoint a secret, so others do not hijack it and abuse the push functionality.
Value
A string.
Examples
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 }); }); Specifications
| Specification |
|---|
| Push API> # dom-pushsubscription-endpoint> |