{{APIRef("HTML DOM")}}
A MessageEvent
is the interface representing a message received by a target, being a {{domxref("WebSocket")}} or a WebRTC {{domxref("RTCDataChannel")}}
The action triggered by this event is set via an event handler set on {{domxref("WebSocket.onmessage")}} or {{domxref("RTCDataChannel.onmessage")}}.
{{AvailableInWorkers}}
Constructor
- {{domxref("MessageEvent.MessageEvent", "MessageEvent()")}}
- Creates a new
MessageEvent
.
Properties
This interface also inherits properties from its parent, {{domxref("Event")}}.
- {{domxref("MessageEvent.data")}} {{ReadonlyInline}}
- Returns a {{domxref("DOMString")}}, {{domxref("Blob")}} or an {{domxref("ArrayBuffer")}} containing the data send by the emitter.
- {{domxref("MessageEvent.origin")}}
- Is a {{domxref("DOMString")}} …
- {{domxref("MessageEvent.ports")}}
- …
- {{domxref("MessageEvent.source")}}
- …
Methods
This interface also inherits methods from its parent, {{domxref("Event")}}.
- {{domxref("MessageEvent.initMessageEvent()")}} {{deprecated_inline}}
- … Do not use this anymore: use the {{domxref("MessageEvent.MessageEvent", "MessageEvent()")}} constructor instead.
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatGeckoDesktop("2.0")}}[1] | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
[1] As of Gecko 11.0 {{geckoRelease("11.0")}}, Gecko supports ArrayBuffer
for data, but not {{domxref("Blob")}}.
See also
- {{domxref("ExtendableMessageEvent")}}, similar to this interface, and used in interfaces that needs to give more flexibility to authors.
- WebSocket API
- WebRTC API