chrome.power

refresh date: 2026-09-25 robots: noindex

Descrizione

Utilizza l'API chrome.power per ignorare le funzionalità di gestione dell'alimentazione del sistema.

Autorizzazioni

power

Utilizzo

Per impostazione predefinita, i sistemi operativi attenuano la luminosità dello schermo quando gli utenti sono inattivi e alla fine sospendono il sistema. Con l'API Power, un'app o un'estensione può mantenere attivo il sistema.

Utilizzando questa API, puoi specificare il livello a cui è disattivata la gestione dell'alimentazione. Il livello "system" mantiene attivo il sistema, ma consente di attenuare 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 per ebook e presentazioni possono mantenere lo schermo e il sistema attivi mentre gli utenti leggono.

Quando un utente ha più app o estensioni attive, ognuna con il proprio livello di consumo, 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", "display" viene utilizzato finché l'app B non viene scaricata o rilascia la richiesta. Se l'app A è ancora attiva, viene utilizzato "system".

Tipi

Level

Enum

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

"display"
Impedisce lo spegnimento o l'attenuazione 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 oscurato o spento o da un salvaschermo. Esce dal salvaschermo se è attualmente attivo.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

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

requestKeepAwake()

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

Richieste di disattivazione temporanea della gestione dell'alimentazione. level descrive il grado in cui la gestione dell'alimentazione deve essere disattivata. Se una richiesta effettuata in precedenza dalla stessa app è ancora attiva, verrà sostituita dalla nuova richiesta.

Parametri