Web/API/ServiceWorkerGlobalScope/onnotificationclick
The ServiceWorkerGlobalScope.onnotificationclick property is an event handler called whenever the notificationclick
event is dispatched on the ServiceWorkerGlobalScope
object, that is when a user clicks on a displayed notification spawned by ServiceWorkerRegistration.showNotification()
.
Notifications created on the main thread or in workers which aren't service workers using the Notification()
constructor will instead receive a click
event on the Notification
object itself.
Note: Trying to create a notification inside the ServiceWorkerGlobalScope
using the Notification()
constructor will throw an error.
Syntax
ServiceWorkerGlobalScope.onnotificationclick = function(NotificationEvent) { ... };
Example
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('/');
}));
};
Specifications
Specification | Status | Comment |
Notifications APIThe definition of 'onnotificationclick' in that specification. | Living Standard | Initial definition. This property is specified on the Notifications_API even though it's part of ServiceWorkerGlobalScope .
|
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 40 |
Edge
Full support ≤79 |
Firefox Full support 44 Full support 44 Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API. |
IE
No support No |
Opera
Full support 24 |
Safari
Full support 11.1 |
WebView Android
Full support 40 |
Chrome Android
Full support 40 |
Firefox Android
Full support 44 |
Opera Android
Full support 24 |
Safari iOS
Full support 11.3 |
Samsung Internet Android
Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- See implementation notes.'
- See implementation notes.
ServiceWorkerGlobalScope.onnotificationclick by Mozilla Contributors is licensed under CC-BY-SA 2.5.