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

Specification Status Comment
Push API
The definition of 'PushMessageData' in that specification.
Working Draft Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support50 ?441 No37 No
arrayBuffer50 ?441 No37 No
blob50 ?441 No37 No
json50 ?441 No37 No
text50 ?441 No37 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No50 ?4837 No5.0
arrayBuffer No50 ?4837 No5.0
blob No50 ?4837 No5.0
json No50 ?4837 No5.0
text No50 ?4837 No5.0

1. Service workers (and Push) have been disabled in the Firefox 45 & 52 Extended Support Releases (ESR).

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, fscholz, alsntjsu, jpmedley, Sheppy, m_t, nyrosmith
 Last updated by: chrisdavidmills,