хром.процессы

Описание

Используйте API chrome.processes для взаимодействия с процессами браузера.

Разрешения

processes

Доступность

Канал разработки

Типы

Cache

Характеристики

  • liveSize

    число

    Используемая часть кэша (в байтах).

  • размер

    число

    Размер кэша в байтах.

Process

Характеристики

  • Процессор

    номер необязательно

    Последнее измерение загрузки ЦП процессом, выраженное в процентах от общего использования одного ядра ЦП всеми потоками процесса. Значение может варьироваться от нуля до CpuInfo.numOfProcessors*100, что может превышать 100% в многопоточных процессах. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • cssCache

    Кэш необязателен

    Актуальная информация о кэше CSS для процесса. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • идентификатор

    число

    Уникальный идентификатор процесса, предоставленный браузером.

  • imageCache

    Кэш необязателен

    Самая актуальная информация о кэше изображений для процесса. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • jsMemoryAllocated

    номер необязательно

    Последнее измерение объёма памяти, выделенной процессу JavaScript, в байтах. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • jsMemoryUsed

    номер необязательно

    Последнее измерение объёма памяти, используемой процессом JavaScript, в байтах. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • naclDebugPort

    число

    Порт отладки для процессов Native Client. Ноль для других типов процессов и процессов NaCl, для которых отладка не включена.

  • сеть

    номер необязательно

    Последнее измерение использования сети процессом в байтах в секунду. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • osProcessId

    число

    Идентификатор процесса, предоставленный ОС.

  • privateMemory

    номер необязательно

    Последнее измерение использования частной памяти процесса в байтах. Доступно только при получении объекта в рамках обратного вызова от onUpdatedWithMemory или getProcessInfo с флагом includeMemory.

  • профиль

    нить

    Профиль, с которым связан процесс.

  • scriptCache

    Кэш необязателен

    Самая актуальная информация о кэше скриптов для процесса. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • sqliteMemory

    номер необязательно

    Последнее измерение использования памяти SQLite процессом в байтах. Доступно только при получении объекта в рамках обратного вызова от onUpdated или onUpdatedWithMemory.

  • задачи

    TaskInfo []

    Массив TaskInfo, представляющий задачи, запущенные в этом процессе.

  • Тип процесса.

ProcessType

Типы процессов браузера.

Перечисление

"браузер"

"рендерер"

"расширение"

"уведомление"

"плагин"

"работник"
Устарело, никогда не будет возвращено.

"накл"

"service_worker"
Устарело, никогда не будет возвращено.

"полезность"

"графический процессор"

"другой"

TaskInfo

Характеристики

  • tabId

    номер необязательно

    Необязательный идентификатор вкладки, если эта задача представляет вкладку, работающую в процессе рендеринга.

  • заголовок

    нить

    Название задачи.

Методы

getProcessIdForTab()

Обещать
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
): Promise<number>

Возвращает идентификатор процесса рендеринга для указанной вкладки.

Параметры

  • tabId

    число

    Идентификатор вкладки, для которой необходимо вернуть идентификатор процесса рендеринга.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (processId: number) => void

    • processId

      число

      Идентификатор процесса рендеринга вкладки.

Возврат

  • Обещание<номер>

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getProcessInfo()

Обещать
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
): Promise<object>

Извлекает информацию о процессе для каждого указанного идентификатора процесса.

Параметры

  • идентификаторы процессов

    номер | номер[]

    Список идентификаторов процессов или идентификатор отдельного процесса, для которого возвращается информация о процессе. Пустой список означает, что запрошены все процессы.

  • включитьпамять

    булев

    Значение true, если требуется подробная информация об использовании памяти. Обратите внимание: сбор информации об использовании памяти приводит к дополнительной загрузке процессора и должен запрашиваться только при необходимости.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (processes: object) => void

    • процессы

      объект

      Словарь объектов Process для каждого запрошенного процесса, являющегося дочерним процессом текущего процесса браузера, индексированный по идентификатору процесса. Метрики, требующие агрегации с течением времени, не будут заполняться в каждом объекте «Процесс».

Возврат

  • Обещание<объект>

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

terminate()

Обещать
chrome.processes.terminate(
  processId: number,
  callback?: function,
): Promise<boolean>

Завершает указанный процесс рендеринга. Аналогично посещению about:crash, но без изменения URL-адреса вкладки.

Параметры

  • processId

    число

    Идентификатор процесса, который необходимо завершить.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (didTerminate: boolean) => void

    • didTerminate

      булев

      True, если завершение процесса прошло успешно, и false в противном случае.

Возврат

  • Обещание<логическое>

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

onCreated

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

Запускается каждый раз при создании процесса, предоставляя соответствующий объект Process.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (process: Process) => void

onExited

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

Запускается каждый раз при завершении процесса, указывая тип выхода.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      число

    • Тип выхода

      число

    • код выхода

      число

onUnresponsive

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

Запускается каждый раз, когда процесс перестает отвечать, предоставляя соответствующий объект Process.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (process: Process) => void

onUpdated

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

Запускается каждый раз, когда диспетчер задач обновляет статистику своего процесса, предоставляя словарь обновленных объектов процесса, индексированных по идентификатору процесса.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (processes: object) => void

    • процессы

      объект

onUpdatedWithMemory

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

Вызывается каждый раз, когда диспетчер задач обновляет статистику своих процессов, предоставляя словарь обновлённых объектов «Процесс», индексированных по идентификатору процесса. Аналогично onUpdate, но с добавлением сведений об использовании памяти в каждый объект «Процесс». Обратите внимание: сбор информации об использовании памяти приводит к дополнительной загрузке процессора и должен прослушиваться только при необходимости.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (processes: object) => void

    • процессы

      объект