ServiceWorkerGlobalScope: notificationclick event

The notificationclick event is fired to indicate that a system notification spawned by ServiceWorkerRegistration.showNotification() has been clicked.

This event is not cancelable and does not bubble.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('notificationclick', event => { });

onnotificationclick = event => { };

Event type

An NotificationEvent. Inherits from Event.

Event properties

Inherits properties from its ancestor, Event.

NotificationEvent.notification Read only: Returns a Notification object representing the notification that was clicked to fire the event.
NotificationEvent.action Read only: Returns the string ID of the notification button the user clicked. This value returns an empty string if the user clicked the notification somewhere other than an action button, or the notification does not have a button.

Examples

You can use the notificationclick event in an addEventListener method:

self.addEventListener('notificationclick', function(event) {
  console.log('On notification click: ', event.notification.tag);
  event.notification.close();

  // This looks to see if the current is already open and
  // focuses if it is
  event.waitUntil(clients.matchAll({
    type: "window"
  }).then(function(clientList) {
    for (var i = 0; i < clientList.length; i++) {
      var client = clientList[i];
      if (client.url == '/' && 'focus' in client)
        return client.focus();
    }
    if (clients.openWindow)
      return clients.openWindow('/');
  }));
});

Or use the onnotificationclick event handler property:

self.onnotificationclick = function(event) {
  console.log('On notification click: ', event.notification.tag);
  event.notification.close();

  // This looks to see if the current is already open and
  // focuses if it is
  event.waitUntil(clients.matchAll({
    type: "window"
  }).then(function(clientList) {
    for (var i = 0; i < clientList.length; i++) {
      var client = clientList[i];
      if (client.url == '/' && 'focus' in client)
        return client.focus();
    }
    if (clients.openWindow)
      return clients.openWindow('/');
  }));
};

You can handle event actions using event.action within a notificationclick event handler:

navigator.serviceWorker.register('sw.js');
Notification.requestPermission(function(result) {
  if (result === 'granted') {
    navigator.serviceWorker.ready.then(function(registration) {
      // Show a notification that includes an action titled Archive.
      registration.showNotification('New mail from Alice',
        {
          actions: [
            {
              action: 'archive',
              title: 'Archive'
            }
          ]
        }
      )
    });
  }
});

self.addEventListener('notificationclick', function(event) {
  event.notification.close();
  if (event.action === 'archive') {
    // User selected the Archive action.
    archiveEmail();
  } else {
    // User selected (e.g., clicked in) the main body of notification.
    clients.openWindow('/inbox');
  }
}, false);

Specifications

Specification
Notifications API Standard # activating-a-notification
Notifications API Standard # dom-serviceworkerglobalscope-onnotificationclick

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`notificationclick_event`	40	17	44 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	No	24	No	40	40	44	27	No	4.0

Name	Web APIs
Version
Badge
Last Updated	2022-04-27T09:33:08Z