Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
* Some parts of this feature may have varying levels of support.
Note: This feature is only available in Service Workers.
The NotificationEvent interface of the Notifications API represents a notification event dispatched on the ServiceWorkerGlobalScope of a ServiceWorker.
This interface inherits from the ExtendableEvent interface.
Note: Only persistent notification events, fired at the ServiceWorkerGlobalScope object, implement the NotificationEvent interface. Non-persistent notification events, fired at the Notification object, implement the Event interface.
NotificationEvent()Creates a new NotificationEvent object.
Also inherits properties from its parent interface, ExtendableEvent.
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.
Also inherits methods from its parent interface, ExtendableEvent.
self.addEventListener("notificationclick", (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((clientList) => {
for (const client of clientList) {
if (client.url === "/" && "focus" in client) return client.focus();
}
if (clients.openWindow) return clients.openWindow("/");
}),
);
});
| Specification |
|---|
| Notifications API> # notificationevent> |
Note: This interface is specified in the Notifications API, but accessed through ServiceWorkerGlobalScope.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
NotificationEvent |
42 | 17 | 44 | 37 | 16Notifications are supported on macOS Ventura and later. |
42 | 44 | 37 | 16.4Notifications are supported in web apps saved to the home screen. |
4.0 | No | NoNotifications are supported in web apps saved to the home screen. |
NotificationEvent |
42 | 17 | 44 | 37 | 16Notifications are supported on macOS Ventura and later. |
42 | 44 | 37 | 16.4Notifications are supported in web apps saved to the home screen. |
4.0 | No | NoNotifications are supported in web apps saved to the home screen. |
action |
48 | 17 | 44 | No | No | 48 | 44 | No | No | 5.0 | No | No |
notification |
42 | 17 | 44 | 37 | No | 42 | 44 | 37 | No | 4.0 | No | No |
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NotificationEvent