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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
PushMessageData | Chrome Full support 50 | Edge Full support ≤79 | Firefox
Full support
44
| 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 | Chrome Full support 50 | Edge Full support ≤79 | Firefox
Full support
44
| 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 | Chrome Full support 50 | Edge Full support ≤79 | Firefox
Full support
44
| 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 | Chrome Full support 50 | Edge Full support ≤79 | Firefox
Full support
44
| 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 | Chrome Full support 50 | Edge Full support ≤79 | Firefox
Full support
44
| 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.