必须双写allowfullscreen和allow="fullscreen"，因Chrome 120+等现代浏览器仅以allow="fullscreen"为权威权限声明，allowfullscreen仅作兼容补丁；单写allowfullscreen在跨域iframe中已失效，会导致requestFullscreen()静默失败。
allowfullscreen 和 allow="fullscreen" 必须双写
只写 allowfullscreen 在 Chrome 120+、Firefox 100+、Safari 16.4+ 中已失效，尤其对跨域 iframe；现代浏览器只认 allow="fullscreen" 为权威权限声明，allowfullscreen 仅作兼容补丁。不双写，全屏按钮点击后大概率静默失败——控制台没报错，Promise 一直 pending，或直接 reject 带 "Fullscreen denied"。
正确写法（一行内，无换行）：
<iframe src="https://example.com/player.html" allowfullscreen allow="fullscreen" webkitallowfullscreen mozallowfullscreen></iframe>
-
allowfullscreen：布尔属性，有即生效，不能写成allowfullscreen="true" -
allow="fullscreen"：值必须是精确字符串"fullscreen"，拼成"full-screen"或"allow-fullscreen"都无效 -
webkitallowfullscreen和mozallowfullscreen是 Safari/Firefox 旧版本兜底项，不加不报错，但加了更稳（尤其 iOS Safari 10–13）
跨域 iframe 下 allow="fullscreen" 失效的三大原因
写了 allow="fullscreen" 还进不了全屏？大概率卡在权限链下游。浏览器会按顺序检查：HTML 属性 → sandbox 策略 → 父页响应头 → 用户手势上下文。任一环节断掉，requestFullscreen() 就不会执行。
- 父页面 HTTP 响应头含
Permissions-Policy: fullscreen 'none'：它会直接覆盖所有 HTML 属性，连allow="fullscreen"都被无视。需删掉该响应头，或改为Permissions-Policy: fullscreen=()（显式放行） - 目标元素不是子页内真实挂载的 DOM：比如父页试图调
iframe.contentWindow.document.documentElement.requestFullscreen()，这永远失败；必须由 iframe 内部用户点击按钮触发，且目标是子页里的<div id="player"> 这类元素 <h3>怎么验证 iframe 真拿到了全屏权限</h3> <p>别只看 HTML 有没有写对，要查浏览器实际赋予的策略。Chrome DevTools 中右键 iframe 元素 → “Inspect iframe” → 右侧 “Permissions” 标签页，确认 <code>fullscreen显示为Allowed。立即学习“前端免费学习笔记（深入）”；
若 iframe 跨域，
contentWindow不可访问，此时只能靠间接方式验证：- 在子页控制台执行
document.fullscreenEnabled，返回true才算就绪 - 子页进入全屏后主动发消息：
window.parent.postMessage({ type: 'FULLSCREEN_ENTERED' }, '*') - 父页监听
message事件，而非依赖document.fullscreenElement === iframeElm（这永远是null）
动态创建 iframe 时 allow 必须在 src 之前设置
用
document.createElement('iframe')创建后，如果先赋值iframe.src再设iframe.allow，权限将不生效——浏览器在加载发起阶段就完成了策略解析，后续修改无效。正确顺序：
const iframe = document.createElement('iframe');<br>iframe.allow = 'fullscreen'; // 必须在 set src 前<br>iframe.src = 'https://thirdparty.com/app.html';<br>document.body.appendChild(iframe);另外，
allow值必须用分号分隔权限项，空格或逗号会彻底失效。例如allow="fullscreen; camera"错误，应为allow="fullscreen (); camera 'self'"（注意括号和引号）。 - 在子页控制台执行
