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

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 }); }); 

Specifications

Specification
Push API
# dom-pushsubscription-endpoint

Browser compatibility