PushManager: registrations() method

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

Note: This feature is available in Web Workers.

The registrations method is used to ask the system about existing push endpoint registrations.

Note: This method has been superseded by the PushManager.getSubscription() method.

Syntax

js
registrations()

Parameters

None.

Return value

A DOMRequest object to handle the success or failure of the method call.

If the method call is successful, the request's result will be an array of PushRegistration objects.

PushRegistration

Those objects are anonymous JavaScript objects with the following properties:

pushEndpoint

A string representing the URL of the endpoint.

version

The current version that the push endpoint is at.

Examples

js
const req = navigator.push.registrations();

req.onsuccess = (e) => {
  if (req.result.length > 0) {
    req.result.forEach((result) => {
      console.log(
        `Existing registration ${result.pushEndpoint} ${result.version}`,
      );
    });
    // Reuse existing endpoints.
  } else {
    // Register for a new endpoint.
    const register = navigator.push.register();
    register.onsuccess = (e) => {
      console.log(`Registered new endpoint: ${register.result}`);
    };
  }
};

Specifications

This feature is not part of any specification anymore. It is no longer on track to become a standard.

Browser compatibility

See also