chrome.processes

Descrizione

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

Autorizzazioni

processes

Disponibilità

Canale di sviluppo

Tipi

Cache

Proprietà

  • liveSize

    numero

    La parte della cache utilizzata, in byte.

  • dimensioni

    numero

    La dimensione della cache, in byte.

Process

Proprietà

  • cpu

    numero facoltativo

    La misurazione più recente dell'utilizzo della CPU da parte del processo, espressa come percentuale di un singolo core della CPU utilizzato in totale, da tutti i thread del processo. Questo restituisce un valore da zero a 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

    numero facoltativo

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

  • jsMemoryUsed

    numero facoltativo

    La misurazione più recente della memoria JavaScript di 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 Native Client. Zero per altri tipi di processi e per i processi NaCl in cui il debug non è abilitato.

  • emittente

    numero facoltativo

    La misurazione più recente dell'utilizzo della rete di 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

    numero facoltativo

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

  • profilo

    stringa

    Il profilo a cui è associato il processo.

  • 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

    numero 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 TaskInfos che rappresenta le attività in esecuzione in questo processo.

  • Il tipo di processo.

ProcessType

I tipi di processi del browser.

Enum

"browser"

"renderer"

"nacl"

"service_worker"

"gpu"

TaskInfo

Proprietà

  • tabId

    numero facoltativo

    ID scheda facoltativo, se questa attività rappresenta una scheda in esecuzione in un processo del renderer.

  • title

    stringa

    Il titolo dell'attività.

Metodi

getProcessIdForTab()

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

Restituisce l'ID del processo di rendering per la scheda specificata.

Parametri

  • tabId

    numero

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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (processId: number)=>void

    • processId

      numero

      ID di processo del processo di rendering della scheda.

Ritorni

  • Promessa<numero>

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

getProcessInfo()

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

Recupera le informazioni di processo per ogni ID processo specificato.

Parametri

  • processIds

    numero|numero[]

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

  • includeMemory

    boolean

    True se è richiesto l'utilizzo dettagliato della memoria. Nota: la raccolta di informazioni sull'utilizzo della memoria comporta un utilizzo aggiuntivo della CPU e deve essere eseguita solo se necessario.

  • callback

    funzione 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 figlio attivo del processo del browser corrente, indicizzato dall'ID processo. Le metriche che richiedono l'aggregazione nel tempo non verranno compilate in ciascun oggetto Process.

Ritorni

  • Promise<object>

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

terminate()

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

Termina il processo di rendering specificato. Equivale a visitare about:crash, ma senza modificare l'URL della scheda.

Parametri

  • processId

    numero

    L'ID del processo da terminare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      True se l'interruzione del processo è riuscita e false in caso contrario.

Ritorni

  • Promise<boolean>

    Le promesse sono supportate solo per Manifest V3 e versioni successive; 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.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (process: Process)=>void

onExited

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

Attivato ogni volta che viene interrotto un processo, specificando 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,
)

Attivato ogni volta che un processo non risponde, fornendo l'oggetto Process in questione.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (process: Process)=>void

onUpdated

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

Attivato ogni volta che Task Manager aggiorna le proprie statistiche di processo, fornendo il dizionario degli oggetti di processo aggiornati, indicizzati per ID di processo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (processes: object)=>void

    • processi

      oggetto

onUpdatedWithMemory

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

Attivato ogni volta che Task Manager aggiorna le proprie statistiche di processo, fornendo il dizionario degli oggetti di processo aggiornati, indicizzati per ID di processo. Identico a onUpdate, con l'aggiunta di dettagli di utilizzo della memoria inclusi in ogni oggetto Process. Nota: la raccolta di 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