ServiceWorkerContainer.onmessage

これは実験的な機能です。本番で使用する前にブラウザー実装状況をチェックしてください。

ServiceWorkerContainer インターフェイスの onmessage プロパティは、message イベントが発生するたびに発火するイベントハンドラーです。 (例えば、Client.postMessage() 呼び出しを介して)着信メッセージを ServiceWorkerContainer オブジェクトに受信したときに発生します。

: 他のウェブメッセージング機能との整合性を保つため、サービスワーカーコンテキストから受信されるメッセージ(onmessage のイベントオブジェクトなど)は、最新のブラウザーでは MessageEvent オブジェクトによって表されます。 (これらは、以前は廃止された ServiceWorkerMessageEvent オブジェクトで表されていました。)

構文

serviceWorkerContainer.onmessage = function(messageevent) { ... }

navigator.serviceWorker.onmessage = function(messageevent) {
  console.log(`received data: ${messageevent.data}`);
}

仕様

仕様 状態 コメント
Service Workers
ServiceWorkerContainer: onmessage の定義
草案 初期定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
onmessage
実験的
Chrome 完全対応 40Edge 完全対応 17
完全対応 17
完全対応 16
無効
無効 From version 16: this feature is behind the Enable service workers preference.
Firefox 完全対応 44
補足
完全対応 44
補足
補足 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
IE 未対応 なしOpera 完全対応 27Safari 完全対応 11.1WebView Android 完全対応 40Chrome Android 完全対応 40Firefox Android 完全対応 44Opera Android 完全対応 27Safari iOS 完全対応 11.3Samsung Internet Android 完全対応 4.0

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。