Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is only available in Service Workers.
The PushEvent interface of the Push API represents a push message that has been received. This event is sent to the global scope of a ServiceWorker. It contains the information sent from an application server to a PushSubscription.
PushEvent()Creates a new PushEvent object.
Inherits properties from its parent, ExtendableEvent. Additional properties:
PushEvent.data Read only
Returns a reference to a PushMessageData object containing data sent to the PushSubscription.
Inherits methods from its parent, ExtendableEvent.
The following example takes data from a PushEvent and displays it on all of the service worker's clients.
self.addEventListener("push", (event) => {
if (!(self.Notification && self.Notification.permission === "granted")) {
return;
}
const data = event.data?.json() ?? {};
const title = data.title || "Something Has Happened";
const message =
data.message || "Here's something you might want to check out.";
const icon = "images/new-notification.png";
const notification = new self.Notification(title, {
body: message,
tag: "simple-push-demo-notification",
icon,
});
notification.addEventListener("click", () => {
clients.openWindow(
"https://example.blog.com/2015/03/04/something-new.html",
);
});
});
| Specification |
|---|
| Push API> # pushevent-interface> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
PushEvent |
42 | 17 | 44 | 37 | 16Notifications are supported on macOS Ventura and later. |
42 | 48 | 37 | 16.4Notifications are supported in web apps saved to the home screen. |
4.0 | No | NoNotifications are supported in web apps saved to the home screen. |
PushEvent |
42 | 17 | 44 | 37 | 16Notifications are supported on macOS Ventura and later. |
42 | 48 | 37 | 16.4Notifications are supported in web apps saved to the home screen. |
4.0 | No | NoNotifications are supported in web apps saved to the home screen. |
data |
50 | 17 | 44 | 37 | 16Notifications are supported on macOS Ventura and later. |
50 | 48 | 37 | 16.4Notifications are supported in web apps saved to the home screen. |
5.0 | No | NoNotifications are supported in web apps saved to the home screen. |
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PushEvent