chrome.power

refresh date: 2026-09-25 robots: noindex

Deskripsi

Gunakan API chrome.power untuk mengganti fitur pengelolaan daya sistem.

Izin

power

Penggunaan

Secara default, sistem operasi meredupkan layar saat pengguna tidak aktif dan pada akhirnya menangguhkan sistem. Dengan API daya, aplikasi atau ekstensi dapat membuat sistem tetap aktif.

Dengan menggunakan API ini, Anda dapat menentukan Level penonaktifan pengelolaan daya. Level "system" membuat sistem tetap aktif, tetapi memungkinkan layar diredupkan atau dinonaktifkan. Misalnya, aplikasi komunikasi dapat terus menerima pesan saat layar nonaktif. Level "display" membuat layar dan sistem tetap aktif. Misalnya, aplikasi e-book dan presentasi dapat membuat layar dan sistem tetap aktif saat pengguna membaca.

Jika pengguna memiliki lebih dari satu aplikasi atau ekstensi yang aktif, masing-masing dengan tingkat daya sendiri, tingkat prioritas tertinggi akan berlaku; "display" selalu lebih diutamakan daripada "system". Misalnya, jika aplikasi A meminta pengelolaan daya "system", dan aplikasi B meminta "display", "display" akan digunakan hingga aplikasi B dibongkar atau merilis permintaannya. Jika aplikasi A masih aktif, "system" akan digunakan.

Jenis

Level

Enum

"system"
Mencegah sistem beralih ke mode tidur sebagai respons terhadap ketidakaktifan pengguna.

"display"
Mencegah layar dinonaktifkan atau diredupkan, atau sistem beralih ke mode tidur sebagai respons terhadap tidak adanya aktivitas pengguna.

Metode

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Merilis permintaan yang sebelumnya dibuat melalui requestKeepAwake().

reportActivity()

Promise Chrome 113+ Khusus ChromeOS
chrome.power.reportActivity(
  callback?: function,
)
: Promise<void>

Melaporkan aktivitas pengguna untuk mengaktifkan layar dari status redup atau nonaktif atau dari screensaver. Keluar dari screensaver jika saat ini aktif.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti:

    () => void

Hasil

  • Promise<void>

    Promise hanya didukung untuk Manifes V3 dan yang lebih baru, platform lain harus menggunakan callback.

requestKeepAwake()

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

Meminta agar pengelolaan daya dinonaktifkan untuk sementara. level menjelaskan tingkat penonaktifan pengelolaan daya. Jika permintaan yang sebelumnya dibuat oleh aplikasi yang sama masih aktif, permintaan tersebut akan digantikan oleh permintaan baru.

Parameter