全屏api测试需覆盖四类边界:浏览器不支持、用户拒绝权限、多前缀兼容、状态异步变更;应通过mock全局对象、promise.reject、前缀遍历和事件监听分别验证兜底逻辑、错误处理、方法兼容性及ui响应。

全屏 API(Fullscreen API)本身是可选功能,浏览器支持不一,且用户可能拒绝全屏请求,因此逻辑分支天然存在。覆盖率不足往往不是因为代码没写,而是测试时未模拟这些边界情况。
覆盖浏览器不支持的场景
现代测试框架(如 Jest、Vitest)中可通过篡改全局对象来模拟无全屏能力的环境:
- 在测试前删除
document.documentElement.requestFullscreen或设为undefined - 确保你的代码有兜底逻辑,例如检查
if (!document.fullscreenElement && !document.webkitIsFullScreen && ...)后执行降级行为 - 验证调用全屏方法时是否安全返回或抛出预期错误(如
TypeError),而非静默失败
覆盖用户拒绝全屏权限的场景
用户点击“否”或自动拒绝后,requestFullscreen() 返回的 Promise 会 reject,但不会抛出异常——需显式监听:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 测试中可 mock Promise.reject() 并断言错误处理逻辑被触发(如 UI 状态回退、提示文案显示)
- 注意 Chrome 等浏览器在非用户手势(如 setTimeout)中调用时也会 reject,这类路径常被遗漏
- 确保 catch 块不只是
console.error,而是更新组件状态或触发可观测反馈
覆盖多套前缀和跨模式兼容路径
虽然现代浏览器基本统一用标准方法,但部分旧版 Safari(webkitEnterFullscreen)、Firefox(mozRequestFullScreen)仍需兼容。覆盖率低常因只测了标准路径:
- 手动遍历各前缀方法并逐个触发,验证是否至少有一个成功进入全屏(或全部跳过)
- 用
jest.mock('path/to/fullscreen-utils')模拟不同方法的存在性组合(如仅存在 webkit 版本) - 检查退出全屏逻辑是否同样覆盖所有对应前缀的 exit 方法(
exitFullscreen/webkitExitFullscreen等)
覆盖 document.fullscreenElement 的状态变化时机
全屏状态变更不是同步的,fullscreenchange 事件才是权威信号。很多逻辑误判为调用即生效:
- 测试中应监听该事件,并在事件回调中验证 UI 更新、按钮状态切换等副作用
- 模拟快速连续调用(如连点两次全屏按钮),验证是否防抖或正确排队,避免状态错乱
- 注意移动端 Safari 不支持
requestFullscreen于<video></video>外元素,该限制需单独覆盖
不复杂但容易忽略:全屏 API 的每个交互节点都自带异步、条件性、环境依赖三重不确定性。真正提升覆盖率的关键,是把「能否执行」和「执行后是否如预期改变状态」拆开验证,而不是只看函数有没有被调用。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










