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 do 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

    Código exclusivo do processo fornecido pelo navegador.

  • imageCache

    Cache opcional

    As informações mais recentes sobre o cache de imagens para o 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 da memória alocada do JavaScript do processo, 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 da memória JavaScript do processo usada, 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 processos e para processos NaCl que não tenham depuração ativada.

  • rede

    número opcional

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

  • perfil

    string

    O perfil a que o processo está associado.

  • scriptCache

    Cache opcional

    As informações mais recentes sobre o cache do script para o processo. Disponível apenas ao receber o objeto 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 ao receber o objeto como parte de um callback de onUpdated ou onUpdatedWithMemory.

  • tasks

    TaskInfo[]

    Matriz de TaskInfos representando as tarefas em execução nesse processo.

  • digitar

    ProcessType

    O tipo de processo.

ProcessType

Os tipos de processos do navegador.

Tipo enumerado

"nacl"

"service_worker"

"gpu"

TaskInfo

Propriedades

  • tabId

    número opcional

    ID da guia opcional, se essa tarefa representa uma guia em execução em um processo do renderizador.

  • title

    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 em que o ID do processo do renderizador vai ser retornado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (processId: number)=>void

    • processId

      number

      ID do processo do renderizador da guia.

Retorna

  • Prometer<número>

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas 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 que é passado 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

    número|número[]

    A lista de IDs ou IDs únicos de processos para os quais as informações do processo precisam ser retornadas. Uma lista vazia indica que todos os processos são solicitados.

  • includeMemory

    boolean

    Verdadeiro se o uso detalhado da memória for necessário. Observação: a coleta de informações de uso da memória gera 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 é um processo filho ativo do processo atual do navegador, 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>

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas 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 que é passado para o callback.

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 optional

    O parâmetro callback tem esta aparência: 

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      Verdadeiro se o encerramento do processo tiver sido bem-sucedido e falso se não for.

Retorna

  • Promise<boolean>

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas 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 que é passado para o callback.

Eventos

onCreated

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

Disparado sempre que um processo é criado, fornecendo o objeto de processo de correlação.

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 toda vez 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

    • exitCode

      number

onUnresponsive

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

Disparado sempre que um processo deixa de responder, fornecendo o objeto de processo de correlação.

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 toda vez que o gerenciador de tarefas atualiza as estatísticas do processo, fornecendo o dicionário de objetos do processo atualizados, indexados pelo 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 toda vez que o gerenciador de tarefas atualiza as estatísticas do processo, fornecendo o dicionário de objetos do processo atualizados, indexados pelo ID do processo. Idêntico a onUpdate, com a adição de detalhes de uso de memória incluídos em cada objeto Process. Observação: a coleta de informações de 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