PushManager: unregister() 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 unregister() method was used to ask the system to unregister and delete the specified endpoint.

Note: In the updated API, a subscription can be unregistered via the PushSubscription.unsubscribe() method.

Syntax

js
unregister(pushEndpoint)

Parameters

pushEndpoint

A pushEndpoint to be unregistered.

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 a PushRegistration object representing the endpoint that has been unregistered.

PushRegistration

Those objects are anonymous JavaScript objects with the following properties:

pushEndpoint

A string representing the URL of the unregistered endpoint.

version

Undefined when unregister.onsuccess is called.

Examples

js
const req = navigator.push.unregister(pushEndpoint);

req.onsuccess = (e) => {
  const endpoint = req.result;
  console.log(`Unregistered endpoint: ${endpoint}`);
};

req.onerror = (e) => {
  console.error(`Error unregistering the endpoint: ${e.error}`);
};

Specifications

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

Browser compatibility

See also