JavaScript PushManager unregister() Method

What You’ll Learn

PushManager.unregister() is a deprecated, non-standard instance method that removed a push endpoint by URL via DOMRequest. Learn what it did, why MDN replaced it with PushSubscription.unsubscribe(), how to feature-detect it, and modern migration patterns—with five examples and try-it labs.

Introduction

When users disable push or your app no longer needs an endpoint, legacy Mozilla code called unregister() on PushManager with the endpoint URL to delete it from the push service.

MDN now marks it deprecated and non-standard. The standardized replacement is PushSubscription.unsubscribe() on the subscription object from getSubscription() or subscribe(). Modern PWAs should never call unregister() in new code.

Understanding unregister()

A legacy instance method on PushManager that unregistered and deleted a specific push endpoint.

• Parameters — pushEndpoint (endpoint URL string).
• Returns — DOMRequest (not a Promise).
• Success result — PushRegistration with pushEndpoint; version is undefined.
• Errors — handle via req.onerror.
• Superseded by — PushSubscription.unsubscribe().
• Available in Web Workers per MDN (where still supported).

📝 Syntax

pushManager.unregister(pushEndpoint)

Return value

A DOMRequest object. On success, req.result describes the unregistered endpoint.

MDN legacy pattern

// Legacy — do not use in new code (MDN sample used navigator.push)
const req = navigator.push.unregister(pushEndpoint);

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

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

⚖️ unregister() vs Modern APIs

Examples Gallery

Examples explain legacy unregister() and show modern subscription.unsubscribe() replacements. Use View Output or Try It Yourself.

const pushEndpoint = "https://push.example.com/old-endpoint";

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

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

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

Unregistered endpoint: https://push.example.com/old-endpoint

function legacyUnregister(pushManager, endpoint) {
  if (typeof pushManager.unregister === "function") {
    return pushManager.unregister(endpoint);
  }
  if (navigator.push && typeof navigator.push.unregister === "function") {
    return navigator.push.unregister(endpoint);
  }
  return null; // not supported — use subscription.unsubscribe()
}

null — unregister not supported, use subscription.unsubscribe()

const req = pushManager.unregister(pushEndpoint);

req.onsuccess = () => {
  removeEndpointFromServer(pushEndpoint);
  showPushDisabledUI();
};

req.onerror = (event) => {
  console.error("Unregister failed:", event.target.error);
};

Unregister failed: NotSupportedError

const registration = await navigator.serviceWorker.ready;
const subscription = await registration.pushManager.getSubscription();

if (subscription) {
  const success = await subscription.unsubscribe();
  if (success) {
    console.log("Push subscription removed");
    await notifyServerUnsubscribe(subscription.endpoint);
  }
}

Push subscription removed

disableBtn.addEventListener("click", async () => {
  const registration = await navigator.serviceWorker.ready;
  const subscription = await registration.pushManager.getSubscription();

  if (!subscription) {
    console.log("Already unsubscribed");
    return;
  }

  await subscription.unsubscribe();
  disableBtn.textContent = "Enable Push";
  console.log("Push disabled");
});

Push disabled

🚀 Common Use Cases (Historical)

• Reading old Mozilla push tutorials that call unregister().
• Cleaning up endpoints created with deprecated register().
• Understanding why modern code uses subscription.unsubscribe().
• Migrating “disable notifications” UI from endpoint URLs to PushSubscription.
• Pairing server-side endpoint deletion with client unsubscribe.

🔧 How It Works

📝 Notes

• Deprecated & non-standard on MDN—not for new production code.
• Superseded by PushSubscription.unsubscribe().
• Not Experimental — it was Mozilla-specific and removed from specs.
• Requires endpoint URL — legacy API; modern API uses the subscription object.
• Notify your server — delete stored subscription after client unsubscribe.
• Related learning: subscribe(), getSubscription(), register(), navigator.serviceWorker, JavaScript hub.

💡 Best Practices