chrome.processes

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.processes para interagir com os processos do navegador.

Permissões

processes

Disponibilidade

Canal de desenvolvedor

Tipos

Cache

Propriedades

  • liveSize

    número

    A parte do cache que é utilizada, em bytes.

  • tamanho

    número

    O tamanho do cache, em bytes.

Process

Propriedades

  • cpu

    número optional

    A medição mais recente do uso da CPU pelo processo, expressa como a porcentagem de um único núcleo de CPU usado no total por todas as linhas de execução do processo. Isso dá um valor de zero a CpuInfo.numOfProcessors*100, que pode exceder 100% em processos multithread. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • cssCache

    Cache opcional

    As informações mais recentes sobre o cache do CSS para o processo. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • ID

    número

    ID exclusivo do processo fornecido pelo navegador.

  • imageCache

    Cache opcional

    As informações mais recentes sobre o cache de imagens do processo. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • jsMemoryAllocated

    número optional

    A medição mais recente da memória alocada em JavaScript do processo, em bytes. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • jsMemoryUsed

    número optional

    A medição mais recente da memória JavaScript usada pelo processo, em bytes. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • naclDebugPort

    número

    A porta de depuração para processos do Cliente nativo. Zero para outros tipos de processo e para processos do NaCl sem depuração ativada.

  • rede

    número optional

    A medição mais recente do uso da rede pelo processo, em bytes por segundo. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • osProcessId

    número

    O ID do processo, conforme fornecido pelo SO.

  • privateMemory

    número optional

    A medição mais recente do uso da memória privada do processo, em bytes. Disponível apenas ao receber o objeto como parte de um callback de onUpdatedWithMemory ou getProcessInfo com a flag includeMemory.

  • perfil

    string

    O perfil associado ao processo.

  • scriptCache

    Cache opcional

    As informações mais recentes sobre o cache de script do processo. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • sqliteMemory

    número optional

    A medição mais recente do uso da memória do SQLite pelo processo, em bytes. Disponível apenas ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • tarefas

    TaskInfo[]

    Matriz de TaskInfos que representam as tarefas em execução neste processo.

  • O tipo de processo.

ProcessType

Os tipos de processos do navegador.

Enumeração

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
Obsoleto, nunca será retornado.

"nacl"

"service_worker"
Obsoleto, nunca será retornado.

"utilidade"

"gpu"

"outro"

TaskInfo

Propriedades

  • tabId

    número optional

    ID da guia opcional, se esta tarefa representar uma guia em execução em um processo de renderização.

  • título

    string

    O título da tarefa.

Métodos

getProcessIdForTab()

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

Retorna o ID do processo de renderização da guia especificada.

Parâmetros

  • tabId

    número

    O ID da guia para a qual o ID do processo do renderizador será retornado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (processId: number) => void

    • processId

      número

      ID do processo de renderização da guia.

Retorna

  • Promise<number>

    Um callback para retornar o ID do processo de renderização de uma guia.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getProcessInfo()

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

Recupera as informações de cada ID de processo especificado.

Parâmetros

  • processIds

    number | number[]

    A lista de IDs de processos ou o ID de um único processo para retornar as informações. Uma lista vazia indica que todos os processos são solicitados.

  • includeMemory

    booleano

    "True" se for necessário um uso detalhado da memória. Observação: a coleta de informações sobre o uso da memória gera um uso extra da CPU e só deve ser consultada quando necessário.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (processes: object) => void

    • processes

      objeto

      Um dicionário de objetos Process para cada processo solicitado que seja um processo filho ativo do processo do navegador atual, indexado por ID do processo. As métricas que exigem agregação ao longo do tempo não serão preenchidas em cada objeto de processo.

Retorna

  • Promise<object>

    Um callback chamado quando as informações de processos são coletadas.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

terminate()

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

Encerra o processo de renderização especificado. Equivalente a acessar "about:crash", mas sem mudar o URL da guia.

Parâmetros

  • processId

    número

    O ID do processo a ser encerrado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (didTerminate: boolean) => void

    • didTerminate

      booleano

      True se a interrupção do processo foi bem-sucedida. Caso contrário, false.

Retorna

  • Promise<boolean>

    Um callback para informar o status da rescisão.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onCreated

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

Acionado sempre que um processo é criado, fornecendo o objeto Process correspondente.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (process: Process) => void

    • difusão reversa que restaura

      Processo

onExited

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

Disparado sempre que um processo é encerrado, fornecendo o tipo de saída.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

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

    • processId

      número

    • exitType

      número

    • exitCode

      número

onUnresponsive

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

Acionado sempre que um processo não responde, fornecendo o objeto "Process" correspondente.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (process: Process) => void

    • difusão reversa que restaura

      Processo

onUpdated

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

Disparado sempre que o Gerenciador de tarefas atualiza as estatísticas de processo, fornecendo o dicionário de objetos de processo atualizados, indexados por ID do processo.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (processes: object) => void

    • processes

      objeto

onUpdatedWithMemory

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

Disparado sempre que o Gerenciador de tarefas atualiza as estatísticas de processo, fornecendo o dicionário de objetos de processo atualizados, indexados por ID do processo. Idêntico a "onUpdate", com a adição de detalhes de uso da memória incluídos em cada objeto "Process". Observação: a coleta de informações sobre o uso da memória gera um uso extra da CPU e só deve ser feita quando necessário.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (processes: object) => void

    • processes

      objeto