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。离线整理了版式、链接和媒体显示。
