MessagePort | Web API

在此页

方法
事件处理程序
事件
范例
规范
浏览器兼容性
另请参阅
相关话题

MessagePort 接口在通道消息 API represents one of the two ports of a MessageChannel , allowing messages to be sent from one port and listening out for them arriving at the other.

注意： 此特征可用于 Web 工作者 .

方法

继承方法来自其父级 EventTarget

postMessage()
start(): Starts the sending of messages queued on the port (only needed when using EventTarget.addEventListener ; it is implied when using MessagePort.onmessage )。
close()

事件处理程序

Inherits event handlers from its parent, EventTarget

onmessage: EventListener called when MessageEvent 类型 message is fired on the port—that is, when the port receives a message.
onmessageerror: EventListener 被调用当 MessageEvent 类型 MessageError is fired—that is, when it receives a message that cannot be deserialized.

事件

message: 被激发当 MessagePort object receives a message.
也可用凭借 onmessage 特性。
messageerror: 被激发当 MessagePort object receives a message that can't be deserialized.
也可用凭借 onmessageerror 特性。

范例

In the following example, you can see a new channel being created using the MessageChannel() 构造函数。

When the IFrame has loaded, we register an onmessage handler for MessageChannel.port1 and transfer MessageChannel.port2 to the IFrame using the window.postMessage method along with a message.

When a message is received back from the IFrame, the onMessage function simply outputs the message to a paragraph.

var channel = new MessageChannel();
var output = document.querySelector('.output');
var iframe = document.querySelector('iframe');
// Wait for the iframe to load
iframe.addEventListener("load", onLoad);
function onLoad() {
  // Listen for messages on port1
  channel.port1.onmessage = onMessage;
  // Transfer port2 to the iframe
  iframe.contentWindow.postMessage('Hello from the main page!', '*', [channel.port2]);
}
// Handle messages received on port1
function onMessage(e) {
  output.innerHTML = e.data;
}

For a full working example, see our channel messaging basic demo on Github ( run it live too ).

规范

规范	状态	注释
HTML 实时标准 The definition of 'Message ports' 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
`MessagePort`	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android Yes	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
`close`	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android 不支持 No	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
`message` event	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android 不支持 No	Opera Android 11.5	Safari iOS 5.1	Samsung Internet Android 1.0
`messageerror` event	Chrome 60	Edge 18	Firefox 57	IE ?	Opera 47	Safari ?	WebView Android 60	Chrome Android 60	Firefox Android 57	Opera Android 47	Safari iOS ?	Samsung Internet Android 8.0
`onmessage`	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android 不支持 No	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
`onmessageerror`	Chrome 60	Edge 18	Firefox 57	IE ?	Opera 47	Safari ?	WebView Android 60	Chrome Android 60	Firefox Android 57	Opera Android 44	Safari iOS ?	Samsung Internet Android 8.0
`postMessage`	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android 不支持 No	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
`start`	Chrome 4	Edge 12	Firefox Yes	IE 10	Opera 10.6	Safari 5	WebView Android Yes	Chrome Android 18	Firefox Android 不支持 No	Opera Android 11	Safari iOS 5.1	Samsung Internet Android 1.0
Available in workers	Chrome Yes	Edge 12	Firefox 41	IE Yes	Opera Yes	Safari Yes	WebView Android Yes	Chrome Android Yes	Firefox Android 41	Opera Android Yes	Safari iOS Yes	Samsung Internet Android Yes

图例

完整支持
不支持
兼容性未知 ?

另请参阅

Using channel messaging

元数据

最后修改： Sep 6, 2019

在此页

方法

事件处理程序

事件

范例

规范

浏览器兼容性

图例

另请参阅

相关话题