Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
onmessage
Collapse the table of content
Expand the table of content

onmessage event

Fires when the user sends a cross-document message or a message is sent from a Worker with IHTMLWindow6::postMessage.

HTML5 Web Messaging, Section 5.3Internet Explorer 8

 

Syntax

HTML Attribute <element onmessage = "handler(event)">
Event Property object.onmessage = handler;
attachEvent Method object.attachEvent("onmessage", handler)
addEventListener Method object.addEventListener("message", handler, useCapture)

 

Event information

SynchronousNo
BubblesNo
CancelableYes

 

Event handler parameters

pEvtObj [in]

Type: IHTMLEventObj

Standards information

Remarks

For info on channel messaging with Workers, see MessagePort and MessageChannel.

The HTMLWindowEvents3::onmessage event is fired when script invokes IHTMLWindow6::postMessage to send the target document a message. The IHTMLEventObj5::data property of the incoming event is set to the value passed in IHTMLWindow6::postMessage.

Security Warning:  For best results, check the IHTMLEventObj5::origin attribute to ensure that messages are only accepted from domains that you expect. For more information, see Section 7.4.2 of the HTML5 (Working Draft) specification from the World Wide Web Consortium (W3C).

To invoke this event, do one of the following:

The pEvtObj parameter is required for the following interfaces:

 

 

Community Additions

ADD
Show:
© 2015 Microsoft