chrome.power

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.power per eseguire l'override delle funzionalità di gestione dell'alimentazione del sistema.

Autorizzazioni

power

Utilizzo

Per impostazione predefinita, i sistemi operativi oscurano lo schermo quando gli utenti sono inattivi e, infine, sospendono il sistema. Con l'API Power, un'app o un'estensione può mantenere attivo il sistema.

Utilizzando questa API, puoi specificare il livello in cui la gestione dell'alimentazione è disattivata. Il livello "system" mantiene il sistema attivo, ma consente di oscurare o spegnere lo schermo. Ad esempio, un'app di comunicazione può continuare a ricevere messaggi mentre lo schermo è spento. Il livello "display" mantiene attivi lo schermo e il sistema. Ad esempio, le app di e-book e presentazioni possono mantenere attivi lo schermo e il sistema mentre gli utenti leggono.

Quando un utente ha più di un'app o un'estensione attiva, ciascuna con il proprio livello di alimentazione, viene applicato il livello con la precedenza più alta; "display" ha sempre la precedenza su "system". Ad esempio, se l'app A richiede la gestione dell'alimentazione "system" e l'app B richiede "display", viene utilizzato "display" finché l'app B non viene scaricata o non rilascia la richiesta. Se l'app A è ancora attiva, viene utilizzato "system".

Tipi

Level

Enum

"system"
Impedisce al sistema di entrare in modalità di sospensione in risposta all'inattività dell'utente.

"display"
Impedisce lo spegnimento o l'oscuramento del display o la sospensione del sistema in risposta all'inattività dell'utente.

Metodi

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Rilascia una richiesta effettuata in precedenza tramite requestKeepAwake().

reportActivity()

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

Segnala un'attività utente per riattivare lo schermo da uno stato di oscuramento o spegnimento o da un salvaschermo. Esce dal salvaschermo se è attualmente attivo.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Le promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

requestKeepAwake()

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

Richiede la disattivazione temporanea della gestione del risparmio energetico. level descrive il livello di disattivazione della gestione dell'alimentazione. Se una richiesta effettuata in precedenza dalla stessa app è ancora attiva, verrà sostituita dalla nuova richiesta.

Parametri