PushMessageData

Push API の PushMessageData インターフェースは、さまざまなフォーマットでサーバから送信されるプッシュテータを取得する方法を提供します。

Fetch API の同様のメソッドが 1 回しか呼び出せないのと異なり、これらは複数回呼び出せます。

プロパティ

なし。

メソッド

PushMessageData.arrayBuffer()

データを ArrayBuffer オブジェクトとして抜き出す。

PushMessageData.blob()

データを Blob オブジェクトとして抜き出す。

PushMessageData.json()

データを JSON オブジェクトとして抜き出す。

PushMessageData.text()

データをプレーンテキスト文字列として抜き出す。

例

Push API Demo では、 最初に JSON.stringify() を介して 文字列に変換したうえで、サーバからプッシュメッセージで JSON オブジェクトを送信します（server.js example を見てください）：

webPush.sendNotification(subscriber[2], 200, obj.key, JSON.stringify({
  action: 'chatMsg',
  name: obj.name,
  msg: obj.msg
}));

メッセージが service worker に到達したら、次の処理を行う前に、PushMessageData.json() を使用して JSON オブジェクトに変換します:

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);
  }
});

仕様

ブラウザ実装状況

• [1] Push（と Service Workers） は、Firefox 45 延長サポート版（ESR）では使用できません。
• [2] Firefox for Android 48 から、既定で Push を使用できます。

関連項目

• Using the Push API