onmessage event
[This documentation is preliminary and is subject to change.]
Fires when the user sends a cross-document message with IHTMLWindow6::postMessage.
.png "HTML5 Web Messaging, Section 5.3"){kind=icon} .png "Internet Explorer 8"){kind=icon} |
Syntax
| HTML Attribute | <element onmessage = "handler(event)"> |
| Event Property | object.onmessage = handler; |
| attachEvent Method | object.attachEvent("onmessage", handler) |
Standards information
- HTML5 Web Messaging, Section 5.3
Event information
| Synchronous | No |
| Bubbles | No |
| Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Remarks
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:
- Send a cross-document message with IHTMLWindow6::postMessage.
The pEvtObj parameter is required for the following interfaces:
Build date: 6/12/2012