跨文档消息传送(cross-document messaging)简称XDM。指的是在来自不同域的页面间传递消息。
- XDM的核心是postMessage()方法。这个方法的目的只有一个:向另一个地方传递数据。
- 对于XDM而言,‘另一个地方’指的是包含在当前页面中的iframe元素,或者由当前页面弹出的窗口。
- postMessage()方法接收两个参数:一条消息和一个表示消息接收方来自哪个域的字符串。其中,第二个参数对保障安全通信非常重要,可以防止浏览器吧消息发送到不安全的地方。
- 接收到XDM消息时,会触发window对象的message事件。触发message事件后,传递给onmessage事件处理程序的事件对象会包含三个重要信息(属性):1.data;2.origin;3.source;
示例:
//前提:www.a.com域中的页面与位于一个内嵌框架中的www.b.com域中的页面通信
//获取到iframe的window
var iframeWindow = document.getElementById('myframe').contentWindow;
//向内嵌框架中发送一条消息:
iframeWindow.postMessage('A secret','http://www.a.com');
//最后一行代码表示向内嵌框架中发送一条'A secret'的信息,并且消息的发送方所在域是 http://www.a.com
注意:使用XDM时候为保险起见,使用postMessage()时,最好还是只传字符串。如果想传入结构化的数据,最佳选择是先在要传入的数据上调用JSON.stringify(),通过postMessage()传入得到的字符串,然后再在onmessage事件处理程序中调用JSON.parse().