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

BroadcastChannel:message 事件

· 52CE 我爱测

BroadcastChannel 接口的 **`message`** 事件在频道收到一条消息时触发。

BroadCastChannel API

BroadcastChannel 接口的 message 事件在频道收到一条消息时触发。

语法

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

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

事件类型

一个 MessageEvent。继承自 Event。

MessageEvent

事件属性

除了下面列出的属性之外,还可以使用父接口 Event 的属性。

  • MessageEvent.data
    • : 由消息发送者发送的数据。
  • MessageEvent.origin
    • : 一个表示消息发送者来源的字符串。
  • MessageEvent.lastEventId
    • : 一个表示事件唯一 ID 的字符串。
  • MessageEvent.source
    • : 一个消息事件源,可以是一个用于表示消息发送者的 WindowProxy、MessagePort 或 ServiceWorker 对象。
  • MessageEvent.ports
    • : 一个与发送消息(通过频道发送消息或向 SharedWorker 发送消息)的频道相关联的 MessagePort 对象的数组。

示例

在这个示例中,有一个 iframe 作为发送者,当用户点击按钮之后,会广播 textarea 中的内容。同时,有两个 iframe 作为接收者,会监听广播的消息,并将结果写入 div 元素。

发送者

<h1>发送者</h1>
<label for="message">请输入要广播的信息:</label><br />
<textarea id="message" name="message" rows="1" cols="40">Hello</textarea>
<button id="broadcast-message" type="button">广播信息</button>
body {
  border: 1px solid black;
  padding: 0.5rem;
  height: 150px;
  font-family: "Fira Sans", sans-serif;
}

h1 {
  font:
    1.6em "Fira Sans",
    sans-serif;
  margin-bottom: 1rem;
}

textarea {
  padding: 0.2rem;
}

label,
br {
  margin: 0.5rem 0;
}

button {
  vertical-align: top;
  height: 1.5rem;
}
const channel = new BroadcastChannel("example-channel");
const messageControl = document.querySelector("#message");
const broadcastMessageButton = document.querySelector("#broadcast-message");

broadcastMessageButton.addEventListener("click", () => {
  channel.postMessage(messageControl.value);
});

接收者 1

<h1>接收者 1</h1>
<div id="received"></div>
body {
  border: 1px solid black;
  padding: 0.5rem;
  height: 100px;
  font-family: "Fira Sans", sans-serif;
}

h1 {
  font:
    1.6em "Fira Sans",
    sans-serif;
  margin-bottom: 1rem;
}
const channel = new BroadcastChannel("example-channel");
channel.addEventListener("message", (event) => {
  received.textContent = event.data;
});

接收者 2

<h1>接收者 2</h1>
<div id="received"></div>
body {
  border: 1px solid black;
  padding: 0.5rem;
  height: 100px;
  font-family: "Fira Sans", sans-serif;
}

h1 {
  font:
    1.6em "Fira Sans",
    sans-serif;
  margin-bottom: 1rem;
}
const channel = new BroadcastChannel("example-channel");
channel.addEventListener("message", (event) => {
  received.textContent = event.data;
});

结果

发送者

接收者 1

接收者 2

规范

浏览器兼容性

参见

  • 相关事件:BroadcastChannel/messageerror_event。

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

资料来源与适用范围

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

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

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