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 insecure contexts (HTTPS), in some or allsupporting browsers.
Note: This feature is available inWeb Workers.
ThegetNotifications() method oftheServiceWorkerRegistration interface returns a list of thenotifications in the order that they were created from the current origin via thecurrent service worker registration. Origins can have many active butdifferently-scoped service worker registrations. Notifications created by one serviceworker on the same origin will not be available to other active service workers onthat same origin.
Syntax
getNotifications()getNotifications(options)Parameters
optionsOptionalAn object containing options to filter the notifications returned. The availableoptions are:
tagOptionalA string representing a notification tag. Ifspecified, only notifications that have this tag will be returned.
Return value
APromise that resolves to a list ofNotification 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 |