PushSubscription: unsubscribe() method

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.

See full compatibility

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 unsubscribe() method of the PushSubscription interface returns a Promise that resolves to a boolean value when the current subscription is successfully unsubscribed.

Syntax

unsubscribe()

Parameters

None.

Return value

A Promise that resolves to a boolean value when the current subscription is successfully unsubscribed.

Examples

navigator.serviceWorker.ready.then((reg) => {
  reg.pushManager.getSubscription().then((subscription) => {
    subscription
      .unsubscribe()
      .then((successful) => {
        // You've successfully unsubscribed
      })
      .catch((e) => {
        // Unsubscribing failed
      });
  });
});

Specifications

Specification
Push API # dom-pushsubscription-unsubscribe

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`unsubscribe()`	Chrome – Full support Chrome 42 (Release date: 2015-04-14) footnote Full support	Edge – Full support Edge 17 (Release date: 2018-04-30) footnote Full support	Firefox – Full support Firefox 44 (Release date: 2016-01-26) footnote Full support	Opera – Full support Opera 29 (Release date: 2015-04-28) footnote Full support	Safari – Full support Safari 16 (Release date: 2022-09-12) footnote footnote Notifications are supported on macOS Ventura and later.	Chrome Android – Full support Chrome Android 50 (Release date: 2016-04-13) footnote Full support	Firefox for Android – Full support Firefox for Android 48 (Release date: 2016-08-02) footnote Full support	Opera Android – Full support Opera Android 37 (Release date: 2016-06-16) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote footnote Notifications are supported in web apps saved to the home screen.	Samsung Internet – Full support Samsung Internet 5 (Release date: 2016-12-15) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote footnote Notifications are supported in web apps saved to the home screen.

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.