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
MessageEventthat will be created. This can be one of XXX -
initOptional -
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 tonullif not specified.origin: AUSVStringrepresenting the origin of the message emitter. This defaults to an empty string ("") if not specified.lastEventId: ADOMStringrepresenting a unique ID for the event. This defaults to an empty string ("") if not specified.source: AnMessageEventSource(which can be aWindowProxy,MessagePort, orServiceWorkerobject) representing the message emitter. This defaults tonullif not set.ports: An array ofMessagePortobjects 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,