在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 相关话题

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

onmessage 特性为 ServiceWorkerContainer interface is an event handler fired whenever a message event occurs — when incoming messages are received to the ServiceWorkerContainer object (e.g., via a Client.postMessage() call).

注意： Messages received from service worker contexts (e.g. as the event object of onmessage) are represented by MessageEvent objects in modern browsers, for consistency with other web messaging features. (They used to be represented by ServiceWorkerMessageEvent objects, which have now been deprecated.)

句法

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

范例

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

规范

规范	状态	注释
服务工作者 The definition of 'ServiceWorkerContainer: onmessage' in that specification.	工作草案	初始定义。

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
onmessage	Chrome 40	Edge 17 17 16 Disabled Disabled 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 不支持 No	Opera 27	Safari 11.1	WebView Android 40	Chrome Android 40	Firefox Android 44	Opera Android 27	Safari iOS 11.3	Samsung Internet Android 4.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

见实现注意事项。

用户必须明确启用此特征。

用户必须明确启用此特征。

元数据

• 最后修改： Jun 1, 2020

相关话题

1. 服务工作者 API
2. ServiceWorkerContainer
3. 特性

   1. controller
   2. oncontrollerchange
   3. onerror
   4. onmessage
   5. ready
4. 方法

   1. getRegistration()
   2. getRegistrations()
   3. register()
5. 事件

   1. message
6. 继承：

   1. EventTarget
7. Related pages for Service Workers API

   1. 缓存
   2. CacheStorage
   3. Client
   4. Clients
   5. ExtendableEvent
   6. FetchEvent
   7. InstallEvent
   8. Navigator.serviceWorker
   9. NotificationEvent
   10. PeriodicSyncEvent
   11. PeriodicSyncManager
   12. PeriodicSyncRegistration
   13. ServiceWorker
   14. ServiceWorkerGlobalScope
   15. ServiceWorkerRegistration
   16. SyncEvent
   17. SyncManager
   18. SyncRegistration
   19. WindowClient