全屏API调用失败不可盲目重试，须先判断错误类型：TypeError/SecurityError因触发时机或权限问题不可重试，应提示用户手动触发；AbortError为用户取消无需重试；其他DOMException可轻量检查后重试。
全屏 API 调用失败很常见，直接忽略或静默失败会导致体验断层。关键不是“重试”，而是降级 + 意图确认 + 环境适配——因为多数失败是用户拒绝、API 不可用或调用时机不当导致的，重试本身无法解决根本问题。
判断失败原因再决定是否“重试”
全屏请求（element.requestFullscreen()）返回 Promise，reject 时需检查原因：
-
TypeError 或 SecurityError：说明当前上下文不支持（如非用户手势触发、iframe 未加
allowfullscreen、HTTP 非安全上下文），这类错误不可重试，应提示用户手动触发（例如点击按钮后再调） - AbortError：用户主动取消（按 ESC 或点击退出），无需重试，但可保留 UI 状态（如按钮仍显示“进入全屏”）
-
其他错误（如 DOMException）：可能是元素已移除、被隐藏或不在文档中，此时可做轻量检查（如
element.isConnected && getComputedStyle(element).display !== 'none'），满足条件再尝试一次
封装带降级策略的全屏函数
不依赖盲目重试，而是提供 fallback 行为：
- 若原生全屏失败，自动尝试
document.documentElement.webkitRequestFullscreen（Safari）或document.documentElement.msRequestFullscreen（旧 Edge） - 若所有全屏 API 均不可用，降级为“最大化容器”：给目标元素添加 CSS 类（如
fullscreen-fallback），设为position: fixed; top: 0; left: 0; width: 100vw; height: 100vh; z-index: 9999;，并禁用页面滚动 - 同步更新按钮文案与状态（如从“全屏”变为“退出（模拟）”），避免用户困惑
确保调用符合用户手势约束
现代浏览器强制要求全屏必须由用户手势（click/tap/keydown）直接触发。常见陷阱：
立即学习“Java免费学习笔记（深入）”；
- 在异步回调（如
setTimeout、fetch.then、Promise.resolve().then）中调用 —— 必然失败 - 在自定义事件（如
dispatchEvent(new CustomEvent('show'))）中调用 —— 不被视为可信手势 - 正确做法：将
requestFullscreen()放在原生 click/tap 事件处理器最内层，不跨微任务
监听全屏状态变化，而非只依赖调用结果
即使调用成功，用户也可能中途退出。应同时监听：
-
document.onfullscreenchange（标准） -
document.onwebkitfullscreenchange（Safari） -
document.onmsfullscreenchange（旧 Edge）
在监听回调中统一更新 UI 和业务逻辑（如暂停视频、调整布局），比单纯捕获 Promise reject 更可靠。
真正健壮的全屏逻辑，不是反复调用 requestFullscreen，而是理解浏览器限制、尊重用户选择、提供合理替代，并让状态变化可感知、可响应。
