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 PushMessageData interface of the Push API provides methods which let you retrieve the push data sent by a server in various formats.
Unlike the similar methods in the Fetch API, which only allow the method to be invoked once, these methods can be called multiple times.
Messages received through the Push API are sent encrypted by push services and then automatically decrypted by browsers before they are made accessible through the methods of the PushMessageData interface.
None.
PushMessageData.arrayBuffer()Extracts the data as an ArrayBuffer object.
PushMessageData.blob()Extracts the data as a Blob object.
PushMessageData.bytes()Extracts the data as a Uint8Array object.
PushMessageData.json()Extracts the data as a JSON object.
PushMessageData.text()Extracts the data as a plain text string.
self.addEventListener("push", (event) => {
const obj = event.data.json();
if (obj.action === "subscribe" || obj.action === "unsubscribe") {
fireNotification(obj, event);
port.postMessage(obj);
} else if (obj.action === "init" || obj.action === "chatMsg") {
port.postMessage(obj);
}
});
| Specification |
|---|
| Push API> # pushmessagedata-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 | |
PushMessageData |
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. |
arrayBuffer |
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. |
blob |
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. |
bytes |
132 | 132 | 128 | 117 | 18 | 132 | 128 | 87 | 18 | No | No | No |
json |
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. |
text |
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/PushMessageData