message

An message event informs the target, a WebSocket, RTCDataConnection or a BroadcastChannel object, that a message has been received.

If the target is a RTCDataConnection, an event handler for this event can be added via the RTCDataConnection.onmessage property.

If the target is a BroadcastChannel, an event handler for this event can be added via the BroadcastChannel.onmessage property.

General info

Interface
MessageEvent
Bubbles
No
Cancelable
No
Target
RTCDataChannelEvent, WebSocket, BroadcastChannel
Default Action
None

Properties

A MessageEvent being an Event, this event also implements these properties.

data Read only
Is a DOMString containing the message received.

Methods

A MessageEvent being an Event, this event also implements these properties.

Specifications

Specification Status Comment
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'message on RTCDataChannel' in that specification.		 Working Draft Adds RTCDataChannel as an EventTarget and defines when this event is sent.
WHATWG HTML Living Standard
The definition of 'message on BroadcastChannel' in that specification.		 Living Standard Adds BroadcastChannel as an EventTarget and defines when this event is sent.

Browser compatibility

  
Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) No support (Yes) ?
on BroadcastChannel No support No support 38 (38) No support No support No support
  
Feature Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? (Yes) ? No support ? ?
on BroadcastChannel  No support No support No support 38.0 (38) No support No support No support

See also

  • WebRTC
  • BroadcastChannel API
  • WebSockets

Document Tags and Contributors

Tags: 
 Contributors to this page: erikadoyle, teoli
 Last updated by: erikadoyle,