iframe全屏失败主因是权限配置错误：现代浏览器需同时设置allow="fullscreen"和allowfullscreen，跨域必须双写，且父页permissions-policy响应头会覆盖html属性；requestfullscreen()需在iframe内由用户手势触发、目标为子页dom元素、且iframe已加载并启用scripts；全屏状态属子文档，父页需通过postmessage监听；ios safari等平台存在固有限制。
iframe 全屏请求失败，90% 是因为没写对 allow 属性
加 allowfullscreen 还报错？那大概率是用了过时写法或漏了关键配置。现代浏览器（Chrome 120+、Firefox 100+）已将权限控制收敛到 allow="fullscreen"，allowfullscreen 仅作兼容补丁，不能替代它。
-
allowfullscreen是布尔属性，不带值；allow="fullscreen"的值必须是字符串"fullscreen"，拼错成"full-screen"或"allow-fullscreen"都无效 - 跨域 iframe 必须双写：
<iframe src="https://thirdparty.com/app.html" allowfullscreen allow="fullscreen"></iframe> - 同源 iframe 可只写
allowfullscreen，但建议统一双写，避免环境差异导致行为不一致 - 如果父页面响应头含
Permissions-Policy: fullscreen 'none'，HTML 属性会被直接覆盖，此时删掉响应头比改 HTML 更有效
requestFullscreen() 在 iframe 内静默失败的三大硬性条件
不是代码没执行，而是浏览器在入口就拦截了——根本不会走到 JS 报错那步。常见现象：点击按钮无反应、Promise pending 不 resolve、控制台安静得像没这回事。
- 用户手势必须发生在 iframe 内部：父页面按钮
click后调用iframe.contentWindow.postMessage(...)让子页自己触发requestFullscreen()，不能由父页代理调用 - iframe 必须已加载完成且 JS 可执行：若带
sandbox属性，需显式加allow-scripts，否则子页 JS 根本不运行 - 目标元素必须是子页面内真实挂载的 DOM 节点，且不能是
<iframe></iframe>自身（iframeElm.requestFullscreen()永远无效），只能是子页里的<div id="player"> 这类元素 <h3>父页面 document.fullscreenElement 为什么永远是 null</h3> <p>这不是 bug，是规范行为。iframe 全屏后，全屏状态属于子文档（<code>iframe.contentDocument），父文档的document.fullscreenElement始终为null，哪怕你看到整个视口都被占满了。- 别试图通过
parent.document.fullscreenElement === iframeElm判断子页是否全屏——这永远不成立 - 正确做法是子页主动通知：子页进入全屏后发
window.parent.postMessage({ type: 'FULLSCREEN_ENTERED' }, '*')，父页监听window.addEventListener('message', ...) - 父页如需同步滚动锁定等副作用，必须在收到消息后手动执行，比如
document.body.style.overflow = 'hidden' - 子页退出全屏时也要发消息，否则父页无法恢复 UI 状态（比如隐藏的工具栏）
移动端和旧版 Safari 的 iframe 全屏兼容陷阱
所谓“全屏”，在 iOS Safari 和部分安卓 WebView 里只是视觉缩放，
document.fullscreenElement仍为null，fullscreenchange事件也不触发——这是平台级限制，没法靠 JS 绕过。- iOS Safari 完全不支持跨域 iframe 全屏，同域下也仅支持
<video></video>元素调用requestFullscreen()，普通<div> 会静默失败 <li>安卓 WebView（尤其系统自带）可能 fallback 到 viewport 缩放，此时需配合 CSS 检测：<code>@supports (aspect-ratio) { ... }或监听window.innerHeight突变来间接判断 - 不要依赖
document.exitFullscreen()在移动端强制退出——它可能无效果，应设计降级方案：比如显示“双击放大”提示，或用transform: scale(1.5)模拟沉浸感
真正卡住人的从来不是 API 写法，而是权限链上某一处没对齐：HTTP 响应头、HTML 属性、sandbox 配置、用户手势位置、跨域策略、甚至浏览器版本——少一个，
requestFullscreen()就进不了子文档的全屏上下文。 - 别试图通过
