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

BroadcastChannel:messageerror 事件

· 52CE 我爱测

BroadcastChannel 接口的 **`messageerror`** 事件在无法反序列化的消息到达频道时触发。

BroadCastChannel API

BroadcastChannel 接口的 messageerror 事件在无法反序列化的消息到达频道时触发。

语法

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

addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }

事件类型

一个 MessageEvent。继承自 Event。

MessageEvent

事件属性

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

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

示例

此代码使用 EventTarget.addEventListener 来监听消息和错误:

const channel = new BroadcastChannel("example-channel");

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

channel.addEventListener("messageerror", (event) => {
  console.error(event);
});

下述代码也实现了相同需求,但使用 onmessage 和 onmessageerror 事件处理器属性:

const channel = new BroadcastChannel("example-channel");

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

channel.onmessageerror = (event) => {
  console.log(event);
};

规范

浏览器兼容性

参见

  • 相关事件:BroadcastChannel/message_event。

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

资料来源与适用范围

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

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

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