讲师中心 微信公众号
AI工具推荐 视频效率加速

HTML中使用postMessage实现iframe跨域通信的完整方案

千丽大大_8619

千丽大大_8619

发布时间:2026-05-13 14:45:47

|

576人浏览过

|

来源于php中文网

原创

postMessage发送消息必须指定准确targetOrigin,否则浏览器静默丢弃;接收方须校验event.origin并比对event.source,不可仅依赖message监听。

html中使用postmessage实现iframe跨域通信的完整方案

postMessage 发送消息时必须指定准确的 targetOrigin

不填或填 "*" 虽然能发出去,但浏览器会直接丢弃——尤其在 iframe 加载完成前就调用、或目标页面重定向后 origin 变更时。真实场景中,targetOrigin 必须与 iframe 当前 contentWindow.location.origin 严格一致(协议 + 域名 + 端口)。可先监听 load 事件,再读取 iframe.contentWindow?.location?.origin;若无法预知目标域,至少应设为具体域名,例如 "https://example.com",而不是 "https://*" 或空字符串。

常见错误现象:Failed to execute 'postMessage' on 'DOMWindow': The target origin provided ('*') does not match the recipient window's origin —— 这不是警告,是静默失败,控制台可能无提示,消息根本没发出去。

接收端必须校验 event.origin 并检查 event.source

仅靠监听 message 事件远远不够。恶意页面可能伪造 postMessage,所以每次收到消息都得做两件事:验证 event.origin 是否在白名单内,确认 event.source 是预期的 iframe 窗口引用(比如和你保存的 iframe.contentWindow 相等)。漏掉任一检查,就可能被钓鱼页面劫持通信。

实操建议:

立即学习“前端免费学习笔记(深入)”;

  • 用 Set 或数组维护可信 origin 列表,避免硬编码字符串比较
  • 发送方首次通信可附带 type: "handshake" 和随机 nonce,接收方回传确认,建立双向信任
  • 不要依赖 event.data 里的自定义字段做权限判断,origin 和 source 才是唯一可信依据

iframe 未加载完成就调用 postMessage 会报错或无效

iframe.contentWindow 在 DOM 插入后立即可访问,但其内部 JS 环境尚未初始化,此时调用 postMessage 会抛出 TypeError: Cannot read property 'postMessage' of null(如果 iframe src 为空或非法),或静默失败(如果 src 已设但未加载完)。

html-to-pptx-converter
html-to-pptx-converter

使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。

下载

可靠做法是监听 iframe 的 load 事件,且在回调中再次确认 iframe.contentWindow 存在、iframe.contentWindow.location.origin 可读:

iframe.addEventListener("load", () => {
  if (iframe.contentWindow && iframe.contentWindow.location?.origin) {
    iframe.contentWindow.postMessage(data, iframe.contentWindow.location.origin);
  }
});

注意:Safari 对跨域 iframe 的 location.origin 访问限制更严,部分版本返回 "null",此时需配合服务端 header(如 Access-Control-Allow-Origin)或改用 window.name 协助识别。

消息序列化限制与大体积数据传输陷阱

postMessage 底层使用结构化克隆算法(structured clone),不支持函数、undefined、Symbol、循环引用对象、DOM 节点等。传 JSON.stringify 后再解析是多余操作,反而增加开销;直接传 plain object 即可。

但要注意:

  • 超过几 MB 的数据(如 base64 图片、大型数组)会导致主线程卡顿,Chrome 有隐式大小限制(约 10–20MB),超出可能被截断或触发 SecurityError
  • 频繁发送小消息(如每秒几十次)会堆积事件队列,接收端应做节流或合并处理
  • 如需双向流式通信,建议封装成简单协议:加 id 字段用于响应匹配,用 type 区分请求/响应/错误

真正难处理的不是怎么发,而是怎么确保对方收到了、处理完了、有没有重试机制——这些都得自己补全,postMessage 本身不提供 ACK 或超时。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

6395

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

3572

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3250

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

3279

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

4979

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3221

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3029

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2668

2023.09.01

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

0

2026.10.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 224人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn