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 in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al 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 in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al 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 in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al 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