dom / latest / pushmessagedata.html /

PushMessageData

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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.

Properties

None.

Methods

PushMessageData.arrayBuffer()

Extracts the data as an ArrayBuffer object.

PushMessageData.blob()

Extracts the data as a Blob object.

PushMessageData.json()

Extracts the data as a JSON object.

PushMessageData.text()

Extracts the data as a plain text string.

Examples

self.addEventListener('push', function(event) {
  var 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);
  }
});

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
PushMessageData
50
17
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
No
37
No
No
See bug 421921.
50
48
37
No
5.0
arrayBuffer
50
17
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
No
37
No
No
50
48
37
No
5.0
blob
50
17
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
No
37
No
No
50
48
37
No
5.0
json
50
17
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
No
37
No
No
50
48
37
No
5.0
text
50
17
44
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
No
37
No
No
50
48
37
No
5.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PushMessageData