在此页

• 构造函数
• 特性
• 方法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

ExtendableMessageEvent 接口在 服务工作者 API represents the event object of a message event fired on a service worker (when a message is received on the ServiceWorkerGlobalScope from another context) — extends the lifetime of such events.

This interface inherits from the ExtendableEvent 接口。

构造函数

ExtendableMessageEvent()

创建新的 ExtendableMessageEvent 对象实例。

特性

继承的特性来自其父级， ExtendableEvent .

ExtendableMessageEvent.data 只读

Returns the event's data. It can be any data type.

ExtendableMessageEvent.origin 只读

Returns the origin of the Client that sent the message.

ExtendableMessageEvent.lastEventId 只读

Represents, in 服务器发送事件 , the last event ID of the event source. This is an empty string.

ExtendableMessageEvent.source 只读

返回引用针对 Client object that sent the message.

ExtendableMessageEvent.ports 只读

Returns the array containing the MessagePort objects representing the ports of the associated message channel.

方法

继承方法来自其父级 ExtendableEvent .

范例

In the below example a page gets a handle to the ServiceWorker object via ServiceWorkerRegistration.active , and then calls its postMessage() 函数。

// in the page being controlled
if (navigator.serviceWorker) {
  navigator.serviceWorker.register('service-worker.js');
  navigator.serviceWorker.addEventListener('message', event => {
    // event is a MessageEvent object
    console.log(`The service worker sent me a message: ${event.data}`);
  });
  navigator.serviceWorker.ready.then( registration => {
    registration.active.postMessage("Hi service worker");
  });
}
					

The service worker can receive the message by listening to the message event:

// in the service worker
addEventListener('message', event => {
  // event is an ExtendableMessageEvent object
  console.log(`The client sent me a message: ${event.data}`);
  event.source.postMessage("Hi client");
});
					

规范

规范	状态	注释
服务工作者 The definition of 'ExtendableMessageEvent' 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
ExtendableMessageEvent	Chrome Yes	Edge ≤18	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android Yes	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android Yes
ExtendableMessageEvent() 构造函数	Chrome ?	Edge ?	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android ?	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android ?
data	Chrome 51	Edge ≤79	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 51	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android 5.0
lastEventId	Chrome ?	Edge 17	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android ?	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android ?
origin	Chrome ?	Edge ?	Firefox 不支持 No	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android ?	Firefox Android 不支持 No	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android ?
ports	Chrome ?	Edge ?	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android ?	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android ?
source	Chrome ?	Edge ?	Firefox 45 注意事项 45 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera ?	Safari 不支持 No	WebView Android 不支持 No	Chrome Android ?	Firefox Android 45	Opera Android ?	Safari iOS 不支持 No	Samsung Internet Android ?

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

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

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

见实现注意事项。

另请参阅

• 使用服务工作者
• 服务工作者基本代码范例
• ServiceWorker 就绪了吗？
• Channel Messaging

元数据

• 最后修改： Jun 2, 2020

相关话题

1. 服务工作者 API
2. ExtendableMessageEvent
3. 构造函数

   1. ExtendableMessageEvent()
4. 特性

   1. data
   2. lastEventId
   3. origin
   4. ports
   5. source
5. 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. ServiceWorkerContainer
   15. ServiceWorkerGlobalScope
   16. ServiceWorkerRegistration
   17. SyncEvent
   18. SyncManager
   19. SyncRegistration
   20. WindowClient