Sends a cross-document message.
Method of dom/Windowdom/Window
Syntax targetFrame.postMessage();
Parameters msg
A String that contains the message data.
targetOriginA Variant of type String that specifies a target URI.
Return ValueNo return value
ExamplesIf Document A (on http://127.0.0.1) contains a reference to the contentWindow property of Document B (on http://localhost), script in Document A can send a message to Document B by calling the postMessage method as follows:
var targetframe = document.getElementsByTagName('iframe')[0];
targetframe.contentWindow.postMessage('Hello World','http://localhost');
The script in Document B can respond to the message by registering the onmessage event handler for incoming messages.
window.addEventListener('message',function(e) {
if (e.origin == 'http://127.0.0.1') {
if (e.data == 'Hello World') {
e.source.postMessage('Hello');
} else {
console.log(e);
}
}
},false);
Notes
**Security Warning: **While “*” is a valid value for targetOrigin, set the parameter to the value you expected to receive; otherwise, the security of your message might be compromised. For more information about this security message, see Section 3.1.2 of the HTML5 Web Messaging Specification (Editor’s Draft) from the World Wide Web Consortium (W3C). The postMessage method allows cooperative text exchange between untrusted modules from different domains embedded within a page. It does so by ensuring a consistent and secure process for text-based data exchange. When a script invokes this method on a window object, the browser sends an onmessage event to the target document on which the data property has been set to the value passed in msg. When a target URI is passed into the method, it must have at least a protocol and a host specified. The message will only be sent if the target window has the same protocol and host as the specified target URI. The postMessage method call does not return until the event listeners of the target document have finished executing.
Standards informationMozilla Developer Network : [postMessage Article]
Microsoft Developer Network: [postMessage Method Article]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4