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
serviceWorkerRegistration.getNotifications(options) .then(function(notificationsList) { ... });
Parameters
- options Optional
- An object containing options to filter the notifications returned. The available options are:
tag
: ADOMString
representing a notification tag. If specified, only notifications that have this tag will be returned.
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 API The 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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getNotifications | Chrome Full support 40 | Edge
Full support
17
| Firefox
Full support
46
| IE No support No | Opera Full support 27 | Safari Full support 11.1 | WebView Android No support No | Chrome Android Full support 40 | Firefox Android Full support 46 | Opera Android Full support 27 | 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.
- User must explicitly enable this feature.
- User must explicitly enable this feature.