MessageEvent()
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
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
MessageEvent |
1 |
12 |
4 |
9 |
? |
4 |
≤37 |
18 |
? |
? |
3 |
1.0 |
See also
-
ExtendableMessageEvent
— similar to this interface but used in interfaces that needs to give more flexibility to authors.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent/MessageEvent