chrome.processes

Descrizione

Utilizza l'API chrome.processes per interagire con i processi del browser.

Autorizzazioni

processes

Disponibilità

Canale per sviluppatori

Tipi

Cache

Proprietà

  • liveSize

    numero

    La parte della cache utilizzata, in byte.

  • dimensioni

    numero

    Le dimensioni della cache, in byte.

Process

Proprietà

  • cpu

    number facoltativo

    La misurazione più recente dell'utilizzo della CPU del processo, espressa come percentuale di un singolo core della CPU utilizzato in totale da tutti i thread del processo. Il risultato è un valore compreso tra 0 e CpuInfo.numOfProcessors*100, che può superare il 100% nei processi multi-thread. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • cssCache

    Cache facoltativa

    Le informazioni più recenti sulla cache CSS per il processo. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • id

    numero

    ID univoco del processo fornito dal browser.

  • imageCache

    Cache facoltativa

    Le informazioni più recenti sulla cache delle immagini per il processo. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • jsMemoryAllocated

    number facoltativo

    La misurazione più recente della memoria allocata da JavaScript del processo, in byte. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • jsMemoryUsed

    number facoltativo

    La misurazione più recente della memoria JavaScript del processo utilizzata, in byte. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • naclDebugPort

    numero

    La porta di debug per i processi del client nativo. Zero per altri tipi di processi e per i processi NaCl per i quali non è abilitato il debug.

  • rete

    number facoltativo

    La misurazione più recente dell'utilizzo della rete del processo, in byte al secondo. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • osProcessId

    numero

    L'ID del processo, fornito dal sistema operativo.

  • privateMemory

    number facoltativo

    La misurazione più recente dell'utilizzo della memoria privata del processo, in byte. Disponibile solo quando l'oggetto viene ricevuto nell'ambito di un callback da onUpdatedWithMemory o getProcessInfo con il flag includeMemory.

  • profilo

    stringa

    Il profilo a cui è associata la procedura.

  • scriptCache

    Cache facoltativa

    Le informazioni più recenti sulla cache dello script per il processo. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • sqliteMemory

    number facoltativo

    La misurazione più recente dell'utilizzo della memoria SQLite del processo, in byte. Disponibile solo quando si riceve l'oggetto come parte di un callback da onUpdated o onUpdatedWithMemory.

  • tasks

    TaskInfo[]

    Array di TaskInfo che rappresentano le attività in esecuzione in questo processo.

  • Il tipo di processo.

ProcessType

I tipi di processi del browser.

Enum

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"
Obsolete, non verrà mai restituito.

"utility"

"gpu"

"other"

TaskInfo

Proprietà

  • tabId

    number facoltativo

    ID scheda facoltativo, se questa attività rappresenta una scheda in esecuzione in un processo di rendering.

  • titolo

    stringa

    Il titolo dell'attività.

Metodi

getProcessIdForTab()

Promessa 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

Restituisce l'ID del processo del visualizzatore per la scheda specificata.

Parametri

  • tabId

    numero

    L'ID della scheda per cui deve essere restituito l'ID processo del visualizzatore.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (processId: number) => void

    • processId

      numero

      ID processo del processo di rendering della scheda.

Resi

  • Promise<number>

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

getProcessInfo()

Promessa 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

Recupera le informazioni sui processi per ogni ID processo specificato.

Parametri

  • processIds

    number | number[]

    L'elenco di ID processo o un singolo ID processo per cui restituire le informazioni sul processo. Un elenco vuoto indica che sono richiesti tutti i processi.

  • includeMemory

    booleano

    True se è richiesto un utilizzo dettagliato della memoria. Tieni presente che la raccolta delle informazioni sull'utilizzo della memoria comporta un utilizzo aggiuntivo della CPU e deve essere eseguita solo quando necessario.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (processes: object) => void

    • processi

      oggetto

      Un dizionario di oggetti Process per ogni processo richiesto che è un processo secondario attivo del processo del browser corrente, indicizzato per ID processo. Le metriche che richiedono l'aggregazione nel tempo non verranno compilate in ogni oggetto Process.

Resi

  • Promise<object>

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

terminate()

Promessa 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

Termina il processo del renderer specificato. È equivalente alla visita di about:crash, ma senza modificare l'URL della scheda.

Parametri

  • processId

    numero

    L'ID del processo da terminare.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (didTerminate: boolean) => void

    • didTerminate

      booleano

      Vero se l'interruzione del processo è andata a buon fine e falso in caso contrario.

Resi

  • Promise<boolean>

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarle entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

Eventi

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

Viene attivato ogni volta che viene creato un processo, fornendo l'oggetto Process corrispondente.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (process: Process) => void

onExited

chrome.processes.onExited.addListener(
  callback: function,
)

Viene attivato ogni volta che un processo viene terminato e fornisce il tipo di uscita.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      numero

    • exitType

      numero

    • exitCode

      numero

onUnresponsive

chrome.processes.onUnresponsive.addListener(
  callback: function,
)

Viene attivato ogni volta che un processo non risponde, fornendo l'oggetto Process corrispondente.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (process: Process) => void

onUpdated

chrome.processes.onUpdated.addListener(
  callback: function,
)

Viene attivato ogni volta che Task Manager aggiorna le statistiche dei processi, fornendo il dizionario degli oggetti Process aggiornati, indicizzati per ID processo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (processes: object) => void

    • processi

      oggetto

onUpdatedWithMemory

chrome.processes.onUpdatedWithMemory.addListener(
  callback: function,
)

Viene attivato ogni volta che Task Manager aggiorna le statistiche dei processi, fornendo il dizionario degli oggetti Process aggiornati, indicizzati per ID processo. Identico a onUpdate, con l'aggiunta di dettagli sull'utilizzo della memoria inclusi in ogni oggetto Process. Tieni presente che la raccolta delle informazioni sull'utilizzo della memoria comporta un utilizzo aggiuntivo della CPU e deve essere ascoltata solo quando necessario.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (processes: object) => void

    • processi

      oggetto