chrome.processes

Descrição

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

Permissões

processes

Disponibilidade

Canal para desenvolvedores

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

    number optional

    A medição mais recente do uso da CPU do 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

    number 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

    number 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 Native Client. Zero para outros tipos de processos e para processos do NaCl que não têm a depuração ativada.

  • rede

    number optional

    A medição mais recente do uso da rede do 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

    number optional

    A medição mais recente do uso de 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

    number optional

    A medição mais recente do uso de 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"

"other"

TaskInfo

Propriedades

  • tabId

    number 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()

Promise 
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 renderizador será retornado.

  • callback

    função opcional

    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>

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

getProcessInfo()

Promise 
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 o qual as informações serão retornadas. Uma lista vazia indica que todos os processos são solicitados.

  • includeMemory

    booleano

    "True" se for necessário usar a memória detalhada. 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 opcional

    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>

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

terminate()

Promise 
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 opcional

    O parâmetro callback tem esta aparência: 

    (didTerminate: boolean) => void

    • didTerminate

      booleano

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

Retorna

  • Promise<boolean>

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

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

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

Acionado 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 ao onUpdate, com a adição de detalhes de uso de memória incluídos em cada objeto Process. 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