chrome.processes

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

    number

    A parte do cache utilizada, em bytes.

  • tamanho

    number

    O tamanho do cache, em bytes.

Process

Propriedades

  • cpu

    número opcional

    A medida mais recente do uso da CPU pelo processo, expressa como a porcentagem de um único núcleo da CPU usado no total por todas as linhas de execução do processo. Isso atribui um valor de zero a CpuInfo.numOfProcessors*100, que pode exceder 100% em processos com várias linhas de execução. 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

    number

    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 opcional

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

  • jsMemoryUsed

    número opcional

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

  • naclDebugPort

    number

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

  • rede

    número opcional

    A medida 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

    number

    O ID do processo, conforme fornecido pelo SO.

  • privateMemory

    número opcional

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

  • scriptCache

    Cache opcional

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

  • sqliteMemory

    número opcional

    A medida mais recente do uso de memória SQLite do 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 representa as tarefas em execução nesse processo.

  • O tipo de processo.

ProcessType

Os tipos de processamento do navegador.

Enumeração

"navegador"

"renderer"

"extensão"

"notificação"

"plug-in"

"trabalhador"

"nacl"

"service_worker"

"utilitário"

"gpu"

"outro"

TaskInfo

Propriedades

  • tabId

    número opcional

    ID da guia opcional, se essa tarefa representa uma guia em execução em um processo do 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

    number

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

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (processId: number) => void

    • processId

      number

      ID do processo do renderizador da guia.

Retorna

  • Promise<number>

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

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

    número | número[]

    A lista de IDs de processo ou ID único de processo para o qual retornar as informações de 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 sobre o uso da memória incorre em 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 é um processo filho ativo do processo atual do navegador, indexado por ID de processo. As métricas que exigem agregação ao longo do tempo não serão preenchidas em cada objeto "Process".

Retorna

  • Promise<object>

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

terminate()

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

Encerra o processo do renderizador especificado. Equivalente a visitar about:crash, mas sem alterar o URL da guia.

Parâmetros

  • processId

    number

    O ID do processo a ser encerrado.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (didTerminate: boolean) => void

    • didTerminate

      booleano

      Verdadeiro se o encerramento do processo tiver sido bem-sucedido. Caso contrário, será falso.

Retorna

  • Promise<boolean>

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

Eventos

onCreated

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

Disparado sempre que um processo é criado, fornecendo o objeto do processo de corrseponding.

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

      number

    • exitType

      number

    • código de saída

      number

onUnresponsive

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

Disparado sempre que um processo deixa de responder, fornecendo o objeto do processo de corrseponding.

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 do processo, fornecendo o dicionário de objetos Process atualizados, indexados por ID de 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 do processo, fornecendo o dicionário de objetos Process atualizados, indexados por ID de processo. Idêntico a 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 incorre em uso extra da CPU e só deve ser detectada quando necessário.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (processes: object) => void

    • processes

      objeto