chrome.power

refresh date: 2026-09-25 robots: noindex

说明

使用 chrome.power API 替换系统的电源管理功能。

权限

power

用法

默认情况下，当用户处于非活动状态时，操作系统会调暗屏幕，并最终暂停系统。借助 Power API，应用或扩展程序可以使系统保持唤醒状态。

使用此 API，您可以指定停用电源管理的级别。"system" 级别可让系统保持活跃状态，但允许屏幕变暗或关闭。例如，通信应用可以在屏幕关闭时继续接收消息。"display" 级别可让屏幕和系统保持活跃状态。例如，电子书和演示文稿应用可以在用户阅读时保持屏幕和系统处于活动状态。

当用户有多个处于活跃状态的应用或扩展程序，且每个应用或扩展程序都有自己的电源级别时，优先级最高的级别会生效；"display" 的优先级始终高于 "system"。例如，如果应用 A 请求 "system" 电源管理，而应用 B 请求 "display"，则系统会使用 "display"，直到应用 B 卸载或释放其请求。如果应用 A 仍处于活跃状态，则使用 "system"。

类型

Level

枚举

"system"
防止系统因用户不活动而进入休眠状态。

"display"
防止显示屏关闭或变暗，或防止系统因用户不活动而进入休眠状态。

方法

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

释放之前通过 requestKeepAwake() 发出的请求。

reportActivity()

Promise Chrome 113 及更高版本 仅限 ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

报告用户活动，以便将屏幕从变暗或关闭状态唤醒，或从屏保状态唤醒。如果屏保当前处于启用状态，则退出屏保。

参数

  • callback

    函数可选

    callback 参数如下所示： 

    () => void

返回

  • 承诺<void>

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
): void

请求暂时停用电源管理。level 描述了应停用电源管理的程度。如果同一应用之前发出的请求仍处于有效状态，则会被新请求替换。

参数