Web/API/PushMessageData

This is an experimental technologyCheck 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 APIThe definition of 'PushMessageData' in that specification.	Working Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`PushMessageData` Experimental'	Chrome Full support 50	Edge Full support ≤79	Firefox Full support 44 Notes' Full support 44 Notes' Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE No support No	Opera Full support 37	Safari No support No	WebView Android No support No	Chrome Android Full support 50	Firefox Android Full support 48	Opera Android Full support 37	Safari iOS No support No	Samsung Internet Android Full support 5.0
`arrayBuffer` Experimental'	Chrome Full support 50	Edge Full support ≤79	Firefox Full support 44 Notes' Full support 44 Notes' Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE No support No	Opera Full support 37	Safari No support No	WebView Android No support No	Chrome Android Full support 50	Firefox Android Full support 48	Opera Android Full support 37	Safari iOS No support No	Samsung Internet Android Full support 5.0
`blob` Experimental'	Chrome Full support 50	Edge Full support ≤79	Firefox Full support 44 Notes' Full support 44 Notes' Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE No support No	Opera Full support 37	Safari No support No	WebView Android No support No	Chrome Android Full support 50	Firefox Android Full support 48	Opera Android Full support 37	Safari iOS No support No	Samsung Internet Android Full support 5.0
`json` Experimental'	Chrome Full support 50	Edge Full support ≤79	Firefox Full support 44 Notes' Full support 44 Notes' Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE No support No	Opera Full support 37	Safari No support No	WebView Android No support No	Chrome Android Full support 50	Firefox Android Full support 48	Opera Android Full support 37	Safari iOS No support No	Samsung Internet Android Full support 5.0
`text` Experimental'	Chrome Full support 50	Edge Full support ≤79	Firefox Full support 44 Notes' Full support 44 Notes' Notes' Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE No support No	Opera Full support 37	Safari No support No	WebView Android No support No	Chrome Android Full support 50	Firefox Android Full support 48	Opera Android Full support 37	Safari iOS No support No	Samsung Internet Android Full support 5.0

Legend

Full support: Full support
No support: No support
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.
See implementation notes.': See implementation notes.

PushMessageData by Mozilla Contributors is licensed under CC-BY-SA 2.5.