当 Window 对象接收到无法反序列化的消息时,会在该对象上触发 messageerror 事件。
此事件不可取消,也不会冒泡。
语法
在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }
事件类型
一个 MessageEvent。继承自 Event。
MessageEvent
事件属性
此接口还继承了其父接口 Event 的属性。
- MessageEvent.data
- : 由消息发送者发送的数据。
- MessageEvent.origin
- : 一个字符串,表示消息发送者的源。
- MessageEvent.lastEventId
- : 一个字符串,表示事件的唯一 ID。
- MessageEvent.source
- : 一个
MessageEventSource(可以是 WindowProxy、MessagePort 或 ServiceWorker 对象),表示消息发送者。
- : 一个
- MessageEvent.ports
- : 一个 MessagePort 对象的数组,表示与消息所经通道关联的端口(在适当情况下,例如在通道消息传递中,或向共享 worker 发送消息时)。
示例
使用 EventTarget/addEventListener 监听 messageerror:
window.addEventListener("messageerror", (event) => {
console.error(event);
});
同样,也可以使用 onmessageerror 事件处理器属性:
window.onmessageerror = (event) => {
console.error(event);
};
规范
浏览器兼容性
参见
- Window.postMessage()
- 相关事件:Window/message_event。
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
