浏览器阻止非用户手势触发全屏是安全策略而非错误，必须在click等可信事件处理器中同步调用requestFullscreen()，禁止setTimeout、Promise.then等异步方式，且需检查元素可见性、iframe权限及浏览器兼容性。
浏览器会阻止非用户手势触发的全屏请求，这是安全策略，不是错误。关键在于确保 requestFullscreen() 被明确的用户操作（如点击、按键）直接调用，不能异步延迟或跨事件循环触发。
必须由用户手势同步触发
全屏 API 只接受“可信的用户激活”（trusted user activation），即事件处理器内直接调用，中间不能有 Promise.then、setTimeout、async/await 等异步跳转。
- ✅ 正确：在
click回调里直接调用element.requestFullscreen() - ❌ 错误：点击后用
setTimeout(() => el.requestFullscreen(), 0)或Promise.resolve().then(() => el.requestFullscreen()) - ❌ 错误：在
fetch成功回调里调用（即使该 fetch 是点击触发的）
检查元素和浏览器兼容性
确保目标元素可全屏（比如 <div>、<video> 通常可以，<iframe> 需加 allowfullscreen 属性），且浏览器支持该 API：
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 用
document.fullscreenEnabled判断当前是否允许进入全屏（注意拼写是fullscreen，不是fullScreen） - 旧版浏览器需兼容前缀：
el.webkitRequestFullscreen?.()、el.msRequestFullscreen?.() - 推荐用 screenfull.js 封装，自动处理前缀和判断
捕获并处理拒绝情况
即使符合手势要求，仍可能被拒绝（例如页面被嵌入 iframe 且未声明权限，或用户禁用了全屏）。应始终监听拒绝原因：
立即学习“Java免费学习笔记（深入）”；
- 监听
document.onfullscreenerror或使用el.requestFullscreen().catch(e => console.error("全屏失败:", e)) - 常见错误类型：
TypeError（API 不可用）、SecurityError（非手势触发）、NotAllowedError（权限被拒或上下文不支持） - 可在 catch 中提示用户：“请手动点击按钮尝试全屏”，避免静默失败
iframe 场景需显式授权
如果页面运行在 iframe 中，父页面必须设置 allow="fullscreen" 属性，否则子页面调用全屏会被直接拒绝：
- 父页 iframe 标签示例：
<iframe src="child.html" allow="fullscreen"></iframe> - 若使用 sandbox，还需加上
allow-scripts和allow-same-origin（视需求而定） - 可通过
document.hasStorageAccess?.()或检查document.fullscreenEnabled是否为false辅助诊断
