chrome.processes

Descrição

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

Permissões

processes

Disponibilidade

Canal de 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

    número opcional

    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 fornece um valor de zero a CpuInfo.numOfProcessors*100, que pode exceder 100% em processos multithread. Disponível apenas quando o objeto é recebido 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 quando o objeto é recebido 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 imagem do processo. Disponível apenas quando o objeto é recebido como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • jsMemoryAllocated

    número opcional

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

  • jsMemoryUsed

    número opcional

    A medição mais recente da memória JavaScript do processo usada, em bytes. Disponível apenas quando o objeto é recebido 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 processo e para processos NaCl que não têm a depuração ativada.

  • rede

    número opcional

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

  • osProcessId

    número

    O ID do processo, conforme fornecido pelo SO.

  • privateMemory

    número opcional

    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 ao qual o processo está associado.

  • scriptCache

    Cache opcional

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

  • sqliteMemory

    número opcional

    A medição mais recente do uso de memória SQLite do processo, em bytes. Disponível apenas quando o objeto é recebido 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"

"nacl"

"service_worker"
Obsoleta, nunca será retornada.

"utility"

"gpu"

"other"

TaskInfo

Propriedades

  • tabId

    número opcional

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

  • título

    string

    O título da tarefa.

Métodos

getProcessIdForTab()

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

Retorna o ID do processo do renderizador para a 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 opcional

    O parâmetro callback tem este formato: 

    (processId: number) => void

    • processId

      número

      ID do processo do renderizador da guia.

Retorna

  • Promise<number>

    As promessas têm suporte no Manifest V3 e versões mais recentes, mas os callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo transmitido para o callback.

getProcessInfo()

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

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

Parâmetros

  • processIds

    number | number[]

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

  • includeMemory

    booleano

    Verdadeiro se o uso detalhado da memória for necessário. A coleta de informações de 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 este formato: 

    (processes: object) => void

    • processes

      objeto

      Um dicionário de objetos Process para cada processo solicitado que é um processo filho ativo do processo do navegador atual, indexado pelo 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 têm suporte no Manifest V3 e versões mais recentes, mas os callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo transmitido para o callback.

terminate()

Promessa 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

Encerra o processo de renderizador 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 este formato: 

    (didTerminate: boolean) => void

    • didTerminate

      booleano

      Verdadeiro se a finalização do processo foi bem-sucedida e falso, caso contrário.

Retorna

  • Promise<boolean>

    As promessas têm suporte no Manifest V3 e versões mais recentes, mas os callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo transmitido para o callback.

Eventos

onCreated

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

É acionado sempre que um processo é criado, fornecendo o objeto de processo correspondente.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (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 este formato: 

    (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 para de responder, fornecendo o objeto de processo correspondente.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (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 do processo, fornecendo o dicionário de objetos de processo atualizados, indexado pelo ID do processo.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (processes: object) => void

    • processes

      objeto

onUpdatedWithMemory

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

É acionado sempre que o Gerenciador de tarefas atualiza as estatísticas do processo, fornecendo o dicionário de objetos de processo atualizados, indexado pelo ID do processo. Idêntico a onUpdate, com a adição de detalhes de uso de memória incluídos em cada objeto de processo. A coleta de informações de uso de memória gera um uso extra de CPU e só deve ser ouvida quando necessário.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (processes: object) => void

    • processes

      objeto