Window: messageerror event
{{APIRef}}
The messageerror
event is fired on a {{domxref('Window')}}
object when it receives a message that can’t be deserialized.
This event is not cancellable and does not bubble.
Syntax
Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}
, or set an event handler property.
addEventListener("messageerror", (event) => {});
onmessageerror = (event) => {};
Event type
A {{domxref("MessageEvent")}}
. Inherits from {{domxref("Event")}}
.
{{InheritanceDiagram("MessageEvent")}}
Event properties
This interface also inherits properties from its parent, {{domxref("Event")}}
.
{{domxref("MessageEvent.data")}}
{{ReadOnlyInline}}
- : The data sent by the message emitter.
{{domxref("MessageEvent.origin")}}
{{ReadOnlyInline}}
- : A string representing the origin of the message emitter.
{{domxref("MessageEvent.lastEventId")}}
{{ReadOnlyInline}}
- : A string representing a unique ID for the event.
{{domxref("MessageEvent.source")}}
{{ReadOnlyInline}}
- : A
MessageEventSource
(which can be a{{glossary("WindowProxy")}}
,{{domxref("MessagePort")}}
, or{{domxref("ServiceWorker")}}
object) representing the message emitter.
- : A
{{domxref("MessageEvent.ports")}}
{{ReadOnlyInline}}
- : An array of
{{domxref("MessagePort")}}
objects 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).
- : An array of
Examples
Listen for messageerror
using {{domxref("EventTarget/addEventListener", "addEventListener()")}}
:
window.addEventListener("messageerror", (event) => {
console.error(event);
});
The same, but using the onmessageerror
event handler property:
window.onmessageerror = (event) => {
console.error(event);
};
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
{{domxref("Window.postMessage()")}}
- Related events:
{{domxref("Window/message_event", "message")}}
.