--- title: MessageEvent slug: Web/API/MessageEvent tags: - API - MessageEvent - WebRTC - Websockets API - 参考 - 接口 translation_of: Web/API/MessageEvent ---

{{APIRef("HTML DOM")}}

  MessageEvent  是接口代表一段被目标对象接收的消息。

用来代表下列情况的消息

通过这个事件触发的动作被定义为一个函数，该函数作为相关{{event("message")}}事件 (例如使用前文所列的onmessage 处理器)的事件处理器。

{{AvailableInWorkers}}

构造函数

{{domxref("MessageEvent.MessageEvent", "MessageEvent()")}}
创建一个新的 消息事件 。

属性

继承其父类 {{domxref("Event")}} 的属性。

{{domxref("MessageEvent.data")}} {{ReadonlyInline}}
返回 {{domxref("DOMString")}}, {{domxref("Blob")}} 或者 {{domxref("ArrayBuffer")}}，包含来自发送者的数据。
{{domxref("MessageEvent.origin")}}
 返回一个表示消息发送者来源的{{domxref("USVString")}} 
{{domxref("MessageEvent.lastEventId")}} {{readonlyInline}}
{{domxref("DOMString")}} representing a unique ID for the event.
{{domxref("MessageEvent.source")}}
MessageEventSource (可以是 {{domxref("WindowProxy")}}, {{domxref("MessagePort")}}, 或 {{domxref("ServiceWorker")}} 对象) 代表消息发送者.
{{domxref("MessageEvent.ports")}}
{{domxref("MessagePort")}}对象数组，表示消息正通过特定通道（数据通道）发送的相关端口（适用于通道消息传输或者向一个共享线程（shared work ）发送消息时）。

方法

继承父类 {{domxref("Event")}} 的方法。

{{domxref("MessageEvent.initMessageEvent()")}} {{deprecated_inline}}
… 不要再使用: 使用 {{domxref("MessageEvent.MessageEvent", "MessageEvent()")}}。

 

示例

在我们的基础共享线程示例 Basic shared worker example (run shared worker)中,我们有两个HTML页, 每一页都用简单的js代码去执行简单的计算. 不同的脚本使用同一个worker文件去执行计算 — 它们都可以访问那个worker文件，即使它们（scripts）运行在不同的窗口.

下面的代码片段展示了使用{{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}构造器创建一个 SharedWorker对象。

var myWorker = new SharedWorker('worker.js');

接下来两份脚本通过一个{{domxref("SharedWorker.port")}}方法创建的{{domxref("MessagePort")}}对象访问worker。如果onmessage事件通过addEventListener被绑定，端口可以用start()方法手动开启：

myWorker.port.start();

当端口被打开，两份脚本各自都可用 port.postMessage() 向worker传消息并用  port.onmessage处理它（worker）传来的消息:

first.onchange = function() {
  myWorker.port.postMessage([first.value,second.value]);
  console.log('Message posted to worker');
}

second.onchange = function() {
  myWorker.port.postMessage([first.value,second.value]);
  console.log('Message posted to worker');
}

myWorker.port.onmessage = function(e) {
  result1.textContent = e.data;
  console.log('Message received from worker');
}

在worker内部我们使用{{domxref("SharedWorkerGlobalScope.onconnect")}} 处理器来连接前文说到相同端口. 与worker相关联的端口可以在{{event("connect")}}事件的ports 属性中访问到 — 接着我们使用{{domxref("MessagePort")}} start() 方法打开端口,  onmessage 处理器来处理主线程传来的消息。

onconnect = function(e) {
  var port = e.ports[0];

  port.addEventListener('message', function(e) {
    var workerResult = 'Result: ' + (e.data[0] * e.data[1]);
    port.postMessage(workerResult);
  });

  port.start(); // Required when using addEventListener. Otherwise called implicitly by onmessage setter.
}

规范

Specification Status Comment
{{SpecName('HTML WHATWG', "#messageevent", "MessageEvent")}} {{Spec2('HTML WHATWG')}}  

浏览器兼容性

{{CompatibilityTable}}

特性 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1 {{CompatVersionUnknown}} {{CompatGeckoDesktop("2.0")}}[1] 9 {{CompatUnknown}} {{CompatSafari('10.0+')}}
特性 Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support {{CompatUnknown}} {{CompatVersionUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} 3.0+

[1] 对于 Gecko 11.0 {{geckoRelease("11.0")}}, Gecko 支持 ArrayBuffer 类型的数据，但不支持 {{domxref("Blob")}} 类型的数据。

参见