Web/API/ServiceWorkerRegistration/getNotifications
The getNotifications()
method of the ServiceWorkerRegistration
interface returns a list of the notifications in the order that they were created from the current origin via the current service worker registration. Origins can have many active but differently-scoped service worker registrations. Notifications created by one service worker on the same origin will not be available to other active services workers on that same origin.
Syntax
s​erviceWorkerRegistration.getNotifications(options) .then(function(notificationsList) { ... });
Parameters
- options Optional
- An object containing options to filter the notifications returned. The available options are:
tag
- A
DOMString
representing a notification tag. If specified, only notifications that have this tag will be returned.
- A
Return value
A Promise
that resolves to a list of Notification
objects.
Example
navigator.serviceWorker.register('sw.js');
var options = { tag : 'user_alerts' };
navigator.serviceWorker.ready.then(function(registration) {
registration.getNotifications(options).then(function(notifications) {
// do something with your notifications
})
});
Specifications
Specification | Status | Comment |
Notifications APIThe definition of 'ServiceWorkerRegistration.getNotifications()' in that specification. | Living Standard | Initial definition |
Browser compatibility
The compatibility table in 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 17 Full support 17 Full support 16 Disabled' From version 16: this feature is behind the |
Firefox Full support 46 Full support 46 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 27 |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 40 |
Firefox Android
Full support 46 |
Opera Android
Full support 27 |
Safari iOS
No support No |
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.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
ServiceWorkerRegistration.getNotifications() by Mozilla Contributors is licensed under CC-BY-SA 2.5.