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 |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
endpoint
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.