Draft
This page is not complete.
The MessageEvent()
constructor creates a new MessageEvent
object instance.
Syntax
var messageEvent = new MessageEvent(type, init);
Parameters
type
- The type of
MessageEvent
that will be created. This can be one of XXX -
init
Optional -
A dictionary object that can contain the following properties:
data
: The data you want contained in the MessageEvent. This can be of any data type, and will default tonull
if not specified.origin
: AUSVString
representing the origin of the message emitter. This defaults to an empty string ("") if not specified.lastEventId
: ADOMString
representing a unique ID for the event. This defaults to an empty string ("") if not specified.source
: AnMessageEventSource
(which can be aWindowProxy
,MessagePort
, orServiceWorker
object) representing the message emitter. This defaults tonull
if not set.ports
: An array ofMessagePort
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). This defaults to an empty array ([]
) if not specified.
Example
var myMessage = new MessageEvent('worker', { data : 'hello' });
Specifications
Specification | Status | Comment |
---|---|---|
Unknown The definition of 'MessageEvent' in that specification. |
Unknown | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 1 | (Yes) | 4.0 (2.0) | 9 | ? | 10.0+ |
origin as USVString and source as MessageEventSource |
(Yes) | ? | 55.0 (55.0) | No support | ? | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | (Yes) | ? | ? | ? | 3.0+ |
origin as USVString and source as MessageEventSource |
? | ? | 55.0 (55.0) | No support | ? | ? |
See also
ExtendableMessageEvent
— similar to this interface but used in interfaces that needs to give more flexibility to authors.
Document Tags and Contributors
Tags:
Contributors to this page:
chrisdavidmills
Last updated by:
chrisdavidmills,