vue组件与嵌套的iframe页面跨域通讯

9,545 阅读4分钟
写在前面:本文是项目开发中遇到过的问题记录,如有不严谨、错误之处,欢迎补充、指正~

参考资料:juejin.cn/post/684490… juejin.cn/post/684490…

需求: 在vue项目中通过iframe嵌套了其他系统中的页面,现在想要实现点击iframe页面中的某个按钮,实现vue项目中路由菜单的跳转。

需求分析:现在vue项目部署代码在 http://168.168.168.168:8080, 其中嵌入的页面部署在sweetgril.cn, 由此我们可以分析出,在页面通讯时会存在跨域问题,接下来,我们进行跨域通讯的调研,最后采用了跨文档通信 API:window.postMessage()

一:为什么会出现跨域问题

跨域的产生出于浏览器的同源策略限制。同源策略是一种约定,它是浏览器最核心也是最基本的安全功能,如果缺少了同源策略,则浏览器的正常功能可能都会受到影响。可以说Web是构建在同源策略基础之上的,浏览器只是针对同源策略的一种实现。同源策略会阻止一个域的javascript脚本和另外一个域的内容进行交互。所谓同源(即指在同一个域),就是两个页面具有相同的协议主机端口号

二:跨文档通信 API:window.postMessage()

MDN地址:developer.mozilla.org/zh-CN/docs/… window.postMessage() 方法可以安全地实现跨源通信。通常,对于两个不同页面的脚本,只有当执行它们的页面位于具有相同的协议(通常为https),端口号(443为https的默认值),以及主机 (两个页面的模数 Document.domain 设置为相同的值) 时,这两个脚本才能相互通信。window.postMessage() 方法提供了一种受控机制来规避此限制,只要正确的使用,这种方法就很安全。

语法:

otherWindow.postMessage(message, targetOrigin, [transfer]);

otherWindow

其他窗口的一个引用,比如iframe的contentWindow属性、执行window.open返回的窗口对象、或者是命名过或数值索引的window.frames。

message

将要发送到其他 window的数据。它将会被结构化克隆算法序列化。这意味着你可以不受什么限制的将数据对象安全的传送给目标窗口而无需自己序列化。

targetOrigin

通过窗口的origin属性来指定哪些窗口能接收到消息事件,其值可以是字符串*(表示无限制)或者一个URI。在发送消息的时候,如果目标窗口的协议、主机地址或端口这三者的任意一项不匹配targetOrigin提供的值,那么消息就不会被发送;只有三者完全匹配,消息才会被发送。这个机制用来控制消息可以发送到哪些窗口;例如,当用postMessage传送密码时,这个参数就显得尤为重要,必须保证它的值与这条包含密码的信息的预期接受者的origin属性完全一致,来防止密码被恶意的第三方截获。如果你明确的知道消息应该发送到哪个窗口,那么请始终提供一个有确切值的targetOrigin,而不是*。不提供确切的目标将导致数据泄露到任何对数据感兴趣的恶意站点。

transfer 可选

是一串和message 同时传递的 Transferable 对象. 这些对象的所有权将被转移给消息的接收方,而发送一方将不再保有所有权。

其他window可以监听分发的message
window.addEventListener('message',receiveMessage,false);
function receiveMessage(event){
  // For Chrome, the origin property is in the event.originalEvent
  // object.
  // 这里不准确,chrome没有这个属性
  // var origin = event.origin || event.originalEvent.origin;
  var origin = event.origin
  if (origin !== "http://example.org:8080")
    return;

  // ...
}
message中的data

从其他window中传递过来的对象

message中的origin

调用 postMessage 时消息发送方窗口的 origin . 这个字符串由 协议、“://“、域名、“ : 端口号”拼接而成。例如 “example.org (隐含端口 443)”、“example.net (隐含端口 80)”、“example.com:8080”。 请注意,这个origin不能保证是该窗口的当前或未来origin,因为postMessage被调用后可能被导航到不同的位置。

message中的source

对发送消息的窗口对象的引用; 您可以使用此来在具有不同origin的两个窗口之间建立双向通信。

三:实际代码操作

1、home.vue 需要进行iframe页面嵌入的vue页面

image.png

2、page.vue 通过点击iframe中的按钮,切换路由后的页面

image.png

3、vue路由配置

image.png

4、vue项目中在main.js中添加监听message事件

image.png

5、嵌入的iframe页面

image.png

image.png

image.png

image.png

四:最后展示效果

vue中home.vue: image.png

点击前三个add按钮,路由均可切换,切换后的页面展示:

image.png

点击第四个add按钮,页面提示错误信息:

image.png 由此发现window.parent.postMessage的'parent'层级数和iframe页面嵌套层级数在通讯传递上有关系,在使用时要特别注意。

五:总结

通过上述过程的尝试,最终在主流浏览器(内心os:不考虑IE啦)中实现了iframe页面和vue页面的跨域通讯,实现了点击iframe页面切换路由的效果。