大网数据广告活动
Web 标准与前端开发

MessagePort:message 事件

· 52CE 我爱测

MessagePort 对象上的 **`message`** 事件在有消息到达该消息频道时触发。

Channel Messaging API

MessagePort 对象上的 message 事件在有消息到达该消息频道时触发。

此事件不可取消,也不会冒泡。

语法

在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。

addEventListener("message", (event) => {});

onmessage = (event) => {};

事件类型

一个 MessageEvent。继承自 Event。

MessageEvent

事件属性

此接口还继承了其父接口 Event 的属性。

  • MessageEvent.data
    • : 由消息发送者发送的数据。
  • MessageEvent.origin
    • : 一个字符串,表示消息发送者的源。
  • MessageEvent.lastEventId
    • : 一个字符串,表示事件的唯一 ID。
  • MessageEvent.source
    • : 一个 MessageEventSource(可以是 WindowProxy、MessagePort 或 ServiceWorker 对象),表示消息发送者。
  • MessageEvent.ports
    • : 一个按顺序包含随消息发送的所有 MessagePort 对象的数组。

示例

假设脚本创建了一个 MessageChannel,并使用以下代码将其中一个端口发送到不同的浏览上下文,比如另一个 <iframe>:

const channel = new MessageChannel();
const myPort = channel.port1;
const targetFrame = window.top.frames[1];
const targetOrigin = "https://example.org";

const messageControl = document.querySelector("#message");
const channelMessageButton = document.querySelector("#channel-message");

channelMessageButton.addEventListener("click", () => {
  myPort.postMessage(messageControl.value);
});

targetFrame.postMessage("启动", targetOrigin, [channel.port2]);

目标可以接收端口并开始监听消息,代码如下:

window.addEventListener("message", (event) => {
  const myPort = event.ports[0];

  myPort.addEventListener("message", (event) => {
    received.textContent = event.data;
  });

  myPort.start();
});

注意,监听器必须先调用 MessagePort.start() 方法,才能将任何消息传递到此端口。只有在使用 addEventListener() 方法时才需要这样做:如果接收方改用 onmessage ,则会隐式调用 start() 方法:

window.addEventListener("message", (event) => {
  const myPort = event.ports[0];

  myPort.onmessage = (event) => {
    received.textContent = event.data;
  };
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。