From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/messageevent/index.html | 192 +++++++++++++++++++++ .../web/api/messageevent/messageevent/index.html | 135 +++++++++++++++ 2 files changed, 327 insertions(+) create mode 100644 files/zh-cn/web/api/messageevent/index.html create mode 100644 files/zh-cn/web/api/messageevent/messageevent/index.html (limited to 'files/zh-cn/web/api/messageevent') diff --git a/files/zh-cn/web/api/messageevent/index.html b/files/zh-cn/web/api/messageevent/index.html new file mode 100644 index 0000000000..6af707a816 --- /dev/null +++ b/files/zh-cn/web/api/messageevent/index.html @@ -0,0 +1,192 @@ +--- +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.
+}
+ +

规范

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', "#messageevent", "MessageEvent")}}{{Spec2('HTML WHATWG')}} 
+ + + +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
特性ChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support1{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}[1]9{{CompatUnknown}}{{CompatSafari('10.0+')}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
特性AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}3.0+
+
+ +

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

+ +

参见

+ + diff --git a/files/zh-cn/web/api/messageevent/messageevent/index.html b/files/zh-cn/web/api/messageevent/messageevent/index.html new file mode 100644 index 0000000000..54e163a42a --- /dev/null +++ b/files/zh-cn/web/api/messageevent/messageevent/index.html @@ -0,0 +1,135 @@ +--- +title: MessageEvent.MessageEvent() +slug: Web/API/MessageEvent/MessageEvent +translation_of: Web/API/MessageEvent/MessageEvent +--- +
{{APIRef("HTML DOM")}}{{draft}}
+ +

MessageEvent()构造函数创建一个新的 {{domxref("MessageEvent")}} 对象实例。

+ +

语法

+ +
var messageEvent = new MessageEvent(type, init);
+ +

参数

+ +
+
type
+
要创建的MessageEvent的类型。这可能是XXX中的一个
+
+

init {{optional_inline}}

+
+
+

可以包含以下属性的dictionary对象：

+ +
    +
  • data: 您希望包含在MessageEvent中的数据。这可以是任何数据类型，如果没有指定，则默认为null。
    • +
  • origin: {{domxref("USVString")}} 表示消息发送源。如果没有指定，则默认为空字符串("")。
    • +
  • lastEventId: {{domxref("DOMString")}} 表示事件的唯一ID。如果没有指定，则默认为空字符串("")。
    • +
  • source: MessageEventSource (可以是 {{domxref("WindowProxy")}}, {{domxref("MessagePort")}}, 或 {{domxref("ServiceWorker")}} 对象) 表示消息发送对象。如果没有设置，则默认为null。
    • +
  • ports:  {{domxref("MessagePort")}} 对象数组，表示正在通过的消息通道关联的端口(在适当的情况下，例如在通道消息传递或向共享工作者发送消息时)。如果没有指定，则默认为空数组([])。
    • +
+
+
+ +

示例

+ +
var myMessage = new MessageEvent('worker', {
+  data : 'hello'
+});
+
+ +

规范

+ + + + + + + + + + + + + + +
规范状态注释
{{SpecName("HTML DOM", "#messageevent", "MessageEvent")}}{{Spec2("HTML DOM")}}Initial definition
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support1{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}9{{CompatUnknown}}{{CompatSafari('10.0+')}}
origin as {{domxref("USVString")}} and source as MessageEventSource{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatGeckoDesktop("55.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}3.0+
origin as {{domxref("USVString")}} and source as MessageEventSource{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("55.0")}}{{CompatNo}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

另见

+ + -- cgit v1.2.3-54-g00ecf