屏幕唤醒锁定 API

"screen-wake-lock" 强大特性启用了本规范所定义的能力。

"screen-wake-lock" 强大特性定义了一个权限撤销算法。要调用Screen Wake Lock 权限撤销算法，请执行以下步骤：

1. 令 document 为当前全局对象的关联 Document。
2. 令 lockList 为 document.[[ActiveLocks]]["screen"]。
3. 对每个 lock 在 lockList 中
   1. 运行释放唤醒锁，参数为 document、lock 与“screen”。

request(type) 方法的步骤如下：

1. 令 document 为this的相关全局对象的关联 Document。
2. 如果 document 不是完全活跃的，则返回一个被拒绝的 Promise，拒因使用NotAllowedError DOMException。
3. 如果 document 未被允许使用名为screen-wake-lock的策略受控特性，则返回一个被拒绝的 Promise，拒因使用NotAllowedError的DOMException。
4. 如果用户代理拒绝了此type的唤醒锁请求，对 document，则返回一个被拒绝的 Promise，拒因NotAllowedError DOMException。
5. 如果 document 的可见性状态为"hidden"，则返回一个被拒绝的 Promise，原因同上。
6. 令 promise 为一个新 Promise。
7. 并行执行以下步骤
   1. 令 state 为请求使用"screen-wake-lock"的权限请求的结果。
   2. 如果 state 为"denied"，则
      1. 在 屏幕唤醒锁任务源上排队一个全局任务，该任务使用 document 的相关全局对象来用NotAllowedError DOMException拒绝 promise。
      2. 中止这些步骤。
   3. 在 屏幕唤醒锁任务源上排队一个全局任务，该任务使用 document 的相关全局对象来执行以下步骤：
      1. 如果 document 不是完全活跃的，则
         1. 以NotAllowedError DOMException拒绝 promise。
         2. 中止这些步骤。
      2. 如果 document 的可见性状态为"hidden"，则
         1. 以NotAllowedError DOMException拒绝 promise。
         2. 中止这些步骤。
      3. 如果 document.[[ActiveLocks]]["screen"]为空，则并行执行以下步骤：
         1. 使用"screen"调用获取唤醒锁。
            注
      4. 令 lock 为一个新创建的WakeLockSentinel对象，其type属性设为 type。
      5. 追加 lock 到 document.[[ActiveLocks]]["screen"]。
      6. 以 lock 解析 promise。
8. 返回 promise。

WakeLockSentinel实例通过以下内部槽位创建：

released getter 的步骤是返回this.[[Released]]。

type getter 的步骤是返回this的唤醒锁类型。

release() 方法的步骤如下：

1. 如果this的[[Released]]为false，则运行释放唤醒锁，参数为 lock（即this）以及对应的type（取自this的type属性）。
2. 返回已解析为 undefined 的 Promise。

onrelease 属性是针对"onrelease"事件处理器的IDL 事件处理属性，其事件类型为"release"。

它用于在WakeLockSentinel对象的句柄被释放时（无论是因调用release()方法，还是因用户代理自行释放）通知脚本。

只要WakeLockSentinel对象有一个或多个针对"release"的事件监听器，并且该对象尚未被释放，必须存在一个从创建该对象的Window到该WakeLockSentinel对象的强引用。

只要在WakeLockSentinel对象上有任务排入屏幕唤醒锁任务源，必须存在一个从创建该对象的Window到该WakeLockSentinel对象的强引用。

用户代理可以在任何时候释放唤醒锁。例如，当

• 检测到异常操作：如无限循环或任务超出设定的时间限制（如果有的话）。
• 电池电量被认为低且正在放电。
• 用户开启了某种设备省电模式。
• 操作系统根据用户在场状态配置了调暗或关闭屏幕的行为。

当Documentdocument不再完全活跃时，用户代理必须执行以下步骤：

1. 对每个 lock 在 document.[[ActiveLocks]]["screen"]
   1. 运行 release a wake lock 使用 document、lock，以及 “screen”。

本规范定义了以下页面可见性更改步骤，使用可见性状态 state 和 document

1. 如果 state 不是 “hidden”，则中止这些步骤。
2. 对每个 lock 在 document.[[ActiveLocks]]["screen"]
   1. 运行 release a wake lock 使用 document、lock，以及 “screen”。

要 acquire a wake lock（获取唤醒锁）给定的 type，请运行以下步骤

1. 如果类型为 type 的 wake lock 不是 applicable，则中止这些步骤。
2. 请求底层操作系统 acquire the wake lock（获取）类型为 type 的唤醒锁。

要 release a wake lock（释放唤醒锁）针对给定的 document、lock 和 type，请运行以下步骤

1. 如果 document.[[ActiveLocks]][type] 不包含 lock，则中止这些步骤。
2. 将 lock 从 document.[[ActiveLocks]][type] 中移除。
3. 如果 document.[[ActiveLocks]][type] 为空，则以并行方式运行以下步骤
   1. 请求底层操作系统 release the wake lock（释放）类型为 type 的唤醒锁，并让 success 为 true（若操作成功）否则为 false。
   2. 如果 success 为 true 且 type 为 "screen"，则运行以下步骤
      1. 重置平台特定的非活动计时器（该计时器决定何时实际关闭屏幕）。
      注
4. 将 lock 的 [[Released]] 设为 true。
5. 触发一个事件，名称为 “release” 于 lock。