在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

草案
此页面不完整。

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

request() 方法在 WakeLock interface returns a Promise that resolves with a WakeLockSentinel object, which allows control over screen dimming and locking.

句法

var wakeLock = navigator.wakeLock.request(type);
					

参数

type

Options are as follows:

• 'screen' : Requests a screen wake lock. Prevents devices from dimming or locking the screen.

返回值

A Promise that resolves with a WakeLockSentinel 对象。

异常

NotAllowedError

Thrown when wake lock is not available, which can happen because:

• Document is not allowed to use screen wake lock due to screen-wake-lock policy.
• Document is not fully active.
• Document is hidden.
• User Agent could not acquire platform's wake lock.

范例

The following asynchronous function requests a WakeLockSentinel 对象。 request() method is wrapped in a try...catch statement to account for if the browser refuses the request for any reason.

const requestWakeLock = async () => {
  try {
    const wakeLock = await navigator.wakeLock.request('screen');
  } catch (err) {
    // the wake lock request fails - usually system related, such low as battery
    console.log(`${err.name}, ${err.message}`);
  }
}
requestWakeLock();
					

规范

规范	状态	注释
Screen Wake Lock API The definition of 'request()' in that specification.	未知	初始定义。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
request	Chrome 84	Edge 84	Firefox No	IE No	Opera Yes	Safari No	WebView Android 84	Chrome Android 84	Firefox Android No	Opera Android Yes	Safari iOS No	Samsung Internet Android Yes

图例

完整支持

完整支持

不支持

不支持

另请参阅

• WakeLock
• Navigator.wakeLock

元数据

• 最后修改： Jul 23, 2020