chrome.processes

Descrizione

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

Autorizzazioni

processes

Disponibilità

Canale Dev

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 CPU utilizzato in totale da tutti i thread del processo. Questo valore va da zero a CpuInfo.numOfProcessors*100, che può superare il 100% nei processi multithread. Disponibile solo quando si riceve l'oggetto nell'ambito di un callback da onUpdated o onUpdatedWithMemory.

  • cssCache

    Cache facoltativo

    Le informazioni più recenti sulla cache CSS per la procedura. Disponibile solo quando si riceve l'oggetto nell'ambito di un callback da onUpdated o onUpdatedWithMemory.

  • id

    numero

    ID univoco del processo fornito dal browser.

  • imageCache

    Cache facoltativo

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

  • jsMemoryAllocated

    number (facoltativo)

    La misurazione più recente della memoria allocata JavaScript del processo, in byte. Disponibile solo quando si riceve l'oggetto nell'ambito 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 nell'ambito 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 per cui il debug non è abilitato.

  • rete

    number (facoltativo)

    La misurazione più recente dell'utilizzo della rete del processo, in byte al secondo. Disponibile solo quando si riceve l'oggetto nell'ambito 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 si riceve l'oggetto nell'ambito di un callback da onUpdatedWithMemory o getProcessInfo con il flag includeMemory.

  • profilo

    stringa

    Il profilo a cui è associato il processo.

  • scriptCache

    Cache facoltativo

    Le informazioni più recenti sulla cache degli script per il processo. Disponibile solo quando si riceve l'oggetto nell'ambito 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 nell'ambito di un callback da onUpdated o onUpdatedWithMemory.

  • tasks

    TaskInfo[]

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

  • Il tipo di procedura.

ProcessType

I tipi di processi del browser.

Enum

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
Obsoleto, non verrà mai restituito.

"nacl"

"service_worker"
Obsoleto, 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,
): Promise<number>

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 processo del renderer.

  • callback

    funzione 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, le altre piattaforme devono utilizzare i callback.

getProcessInfo()

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

Recupera le informazioni sul processo per ogni ID processo specificato.

Parametri

  • processIds

    number | number[]

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

  • includeMemory

    booleano

    True se è richiesto l'utilizzo dettagliato della memoria. Tieni presente che la raccolta di informazioni sull'utilizzo della memoria comporta un utilizzo aggiuntivo della CPU e deve essere eseguita solo quando 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 sia un processo secondario live del processo del browser corrente, indicizzato per ID processo. Le metriche che richiedono l'aggregazione nel tempo non verranno compilate in ogni oggetto Processo.

Resi

  • Promise<object>

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

terminate()

Promessa 
chrome.processes.terminate(
  processId: number,
  callback?: function,
): Promise<boolean>

Termina il processo di rendering specificato. Equivalente alla visita di 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

      booleano

      Vero se l'interruzione del processo è riuscita, falso in caso contrario.

Resi

  • Promise<boolean>

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

Eventi

onCreated

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

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,
)

Attivato ogni volta che un processo viene terminato, fornendo 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 smette di rispondere, 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,
)

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,
)

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 dei dettagli sull'utilizzo della memoria inclusi in ogni oggetto Process. Tieni presente che 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