Window: messageerror event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Themessageerror event is fired on aWindow object when it receives a message that can't be deserialized.
This event is not cancellable and does not bubble.
In this article
Syntax
Use the event name in methods likeaddEventListener(), or set an event handler property.
addEventListener("messageerror", (event) => { })onmessageerror = (event) => { }Event type
AMessageEvent. Inherits fromEvent.
Event properties
This interface also inherits properties from its parent,Event.
MessageEvent.dataRead onlyThe data sent by the message emitter.
MessageEvent.originRead onlyA string representing the origin of the message emitter.
MessageEvent.lastEventIdRead onlyA string representing a unique ID for the event.
MessageEvent.sourceRead onlyA
MessageEventSource(which can be aWindowProxy,MessagePort, orServiceWorkerobject) representing the message emitter.MessageEvent.portsRead onlyAn array of
MessagePortobjects representing the ports associated with the channel the message is being sent through (where appropriate, e.g., in channel messaging or when sending a message to a shared worker).
Examples
Listen formessageerror usingaddEventListener():
window.addEventListener("messageerror", (event) => { console.error(event);});The same, but using theonmessageerror event handler property:
window.onmessageerror = (event) => { console.error(event);};Specifications
| Specification |
|---|
| HTML> # event-messageerror> |
| HTML> # handler-window-onmessageerror> |
Browser compatibility
See also
Window.postMessage()- Related events:
message.