HTML5 window/iframe跨域传递消息 API

来源:互联网 发布:js获取ip地址 编辑:程序博客网 时间:2024/06/05 21:09

原文地址:HTML5′s window.postMessage API
在线示例:Using HTML5's window.postMessage(请打开控制台看日志)
原文日期: 2010年09月03日
翻译日期: 2013年08月24日

我写了一个 MooTools 的插件"PostMessager"来封装window.postMessage,你可以点击这里下载!

HTML5 的  window.postMessage 接口API 还没有多少人了解。  window.postMessage允许多个 window/frame之间跨域传递数据和信息。实质上window.postMessage扮演了一个跨域Ajax请求的角色,当然,并不需要远程服务器来协作。接下来将介绍window.postMessage的工作原理,以及如何在FireFox,IE8+,Opera,Safari和Chrome中使用它.

一、消息发送端
整个过程的第一步,是设定一个"消息源"。通过这个消息源,我们可以往新打开的window(或者iframe)发送window级别的数据(消息)。在下面的示例中,给新窗口发送消息的频率是每6秒一次,并设置事件监听来处理目标window返回的响应信息。

[javascript] view plaincopy
  1. function trace(message){  
  2.     var infos = Array.prototype.slice.call(arguments,0).join(" ");  
  3.     if("console" in window){  
  4.         console.log(infos);  
  5.     } else {  
  6.         alert(infos);  
  7.     }  
  8. };  
  9. // 创建弹出窗口  
  10. var domain = 'http://scriptandstyle.com';  
  11. var myPopup = window.open(domain + '/windowPostMessageListener.html','myWindow');  
  12.   
  13. // 定时发送消息  
  14. setInterval(function(){  
  15.     var message = '现在时间: ' + (new Date().getTime());  
  16.     trace('数据源.发送的消息:  ' + message);  
  17.     myPopup.postMessage(message,domain); //发送数据信息,并设置目标URI  
  18. },6*1000);  
  19.   
  20. function bindEvent(target,noOnEventName,handler){  
  21.     if(window.addEventListener){  
  22.         target.addEventListener(noOnEventName,handler);  
  23.     } else if(window.attachEvent){  
  24.         // IE 的监听设置函数是attachEvent  
  25.         target.attachEvent("on"+noOnEventName,handler);  
  26.     } else {  
  27.         target["on"+noOnEventName]=handler;  
  28.     }  
  29. };  
  30.   
  31. // 监听收到的信息.  
  32. bindEvent(window,'message',function(event) {  
  33.     // 只接收特定域的消息  
  34.     if(event.origin !== 'http://scriptandstyle.com'return;  
  35.     trace('收到的响应信息:  ',event.data);  
  36. },false);  
原文作者使用的是window.addEventListener方法来绑定事件,但是在IE下将会报错(IE是window.attachEvent).当然,你可以创建函数来包装事件,或者使用现成的类库,比如MooTools或者jQuery/dojo来实现。
在上面的示例中,如果新窗口打开正常,那我们可以通过window对象的引用myPopup发送消息,并指定必须匹配的URI(协议、主机名、端口号)(如果用户在子窗口中跳到其他页面,则消息将不会发送).
同样我们也绑定了事件处理函数来接收消息message。在此提醒,校验message事件的origin(源)属性很重要,因为可能接收到所有URI发给自己的消息,在多个frame交互时才不至于混淆。 校验过origin之后,如何处理此消息,取决于你具体的业务和需求。

如果使用iframe的话,那么代码如下:
[javascript] view plaincopy
  1. // 同样创建另一个window(iframe,frame,frameset,top,window这些都属于window相关的对象。)  
  2. var domain = 'http://scriptandstyle.com';  
  3. var iframe = document.getElementById('myIFrame').contentWindow;  
  4.   
  5. // 循环发送消息,当然,也可以采用事件驱动之类的。。。  
  6. setInterval(function(){  
  7.   
  8.     var message = '现在时间: ' + (new Date().getTime());  
  9.     trace('数据源.发送的消息:  ' + message);  
  10.     iframe.postMessage(message,domain); //发送数据信息,并设置目标URI  
  11. },6*1000);  

确保能访问到iframe对象的contentWindow 属性——而不仅仅是iframe对象。

二、消息接收端
整个流程的第二步就是让目标window就绪。目的窗口所要做的,就是监听message事件,当然也要验证事件的origin消息源。再次提醒:message事件处理函数可以接受任何域名发给他的消息,所以验证origin以及只处理信任列表的message非常重要。

[javascript] view plaincopy
  1. // 监听收到的信息.  
  2. bindEvent(window,'message',function(event) {  
  3.     // 只接收特定域的消息  
  4.     if(event.origin !== 'http://davidwalsh.name'return;  
  5.     trace('监听到信息:  ',event.data);  
  6.     // 回复消息  
  7.     event.source.postMessage(""你好,小伙伴们,我已经收到消息了,event.origin);  
  8. },false);  

上面的示例回复了响应信息给请求方。
message事件重要的属性有:
source - 发送message的window/iframe对象
origin - 对应着发送消息window的URI (protocol, domain, and port, 如果有指定的话)
data - 具体的数据信息
对于消息系统以及校验来说,这三个对象是必不可少的。


window.postMessage 使用注意事项
就和其他所有的Web技术一样,如果使用不当(没有验证事件源)那危险性是显而易见的。当然,安全性由你自己来保证。
window.postMessage 很像JavaScript技术中的PHP(哈哈,小广告!).window.postMessage 算是一种很酷炫的技术,你觉得呢?
0 0
原创粉丝点击