ServiceWorkerRegistration: getNotifications() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
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 service workers on
that same origin.
Syntax
getNotifications()
getNotifications(options)
Parameters
optionsOptional-
An object containing options to filter the notifications returned. The available options are:
tagOptional-
A string 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.
Examples
navigator.serviceWorker.register("sw.js");
const options = { tag: "user_alerts" };
navigator.serviceWorker.ready.then((registration) => {
registration.getNotifications(options).then((notifications) => {
// do something with your notifications
});
});
Specifications
| Specification |
|---|
| Notifications API # dom-serviceworkerregistration-getnotifications |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
getNotifications
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.