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

chrome.processes.getProcessIdForTab(
  tabId: number,
): 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.

Retorna

  • Promise<number>

getProcessInfo()

chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
): 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.

Retorna

  • Promise<object>

terminate()

chrome.processes.terminate(
  processId: number,
): 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.

Retorna

  • Promise<boolean>

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