ServiceWorkerMessageEvent

弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Important : In modern browsers, this interface has been deprecated. Service worker messages will now use the MessageEvent interface, for consistency with other web messaging features.

ServiceWorkerMessageEvent interface of the ServiceWorker API contains information about an event sent to a ServiceWorkerContainer target. This extends the default message event to allow setting a ServiceWorker object as the source of a message. The event object is accessed via the handler function of a message event, when fired by a message received from a service worker.

This interface inherits from the Event 接口。

构造函数

ServiceWorkerMessageEvent.ServiceWorkerMessageEvent()
创建新的 ServiceWorkerMessageEvent object instance.

特性

Inherits properties from its parent, Event .

ServiceWorkerMessageEvent.data 只读
Returns the event's data. It can be any data type.
ServiceWorkerMessageEvent.origin 只读
Returns the origin of the service worker's environment settings object.
ServiceWorkerMessageEvent.lastEventId 只读
Represents, in server-sent events , the last event ID of the event source.
ServiceWorkerMessageEvent.source 只读
Returns a reference to the service worker that sent the message.
ServiceWorkerMessageEvent.ports 只读
Returns an array of MessagePort 对象。

方法

Inherits methods from its parent, Event .

范例

When the following code is used inside the main thread to set up a message channel between it and a service worker for sending messages between the two, the event object of onmessage will be a ServiceWorkerMessageEvent .

navigator.serviceWorker.ready.then(function(reg) {
  ...
      // set up a message channel to communicate with the SW
      var channel = new MessageChannel();
      channel.port1.onmessage = function(e) {
        console.log(e);
        handleChannelMessage(e.data);
      }
      mySW = reg.active;
      mySW.postMessage('hello', [channel.port2]);
  });
					

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
ServiceWorkerMessageEvent
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
ServiceWorkerMessageEvent() 构造函数
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
data
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
lastEventId
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
origin
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
ports
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0
source
弃用
Chrome 45 Edge 17
17
16
Disabled
Disabled From version 16: this feature is behind the Enable service workers preference.
Firefox 不支持 44 — 55
注意事项
44 — 55
注意事项
Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
In Firefox 55 and later, the standard MessageEvent interface must be used instead.
IE 不支持 No Opera 24 Safari 不支持 No WebView Android 不支持 No Chrome Android 45 Firefox Android 不支持 44 — 55 Opera Android 24 Safari iOS 不支持 No Samsung Internet Android 4.0

图例

完整支持
完整支持
不支持
不支持
弃用。不要用于新网站。
弃用。不要用于新网站。
见实现注意事项。
用户必须明确启用此特征。
用户必须明确启用此特征。

另请参阅