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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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