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

Описание

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

Разрешения

processes

Доступность

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

Типы

Cache

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

  • liveSize

    число

    Часть кэша, которая используется, в байтах.

  • размер

    число

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

Process

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

  • Процессор

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

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

  • cssCache

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

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

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

    число

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

  • imageCache

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

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

  • jsMemoryAllocated

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

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

  • jsИспользуемая память

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

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

  • naclDebugPort

    число

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

  • сеть

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

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

  • osProcessId

    число

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

  • частнаяПамять

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

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

  • профиль

    нить

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

  • scriptCache

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

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

  • sqliteПамять

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

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

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

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

ProcessType

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

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

"браузер"

"рендерер"

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

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

"плагин"

"работник"

"накл"

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

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

"ГПУ"

"другой"

TaskInfo

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

  • tabId

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

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

  • заголовок

    нить

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

Методы

getProcessIdForTab()

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

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

Параметры

  • tabId

    число

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

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

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

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

    (processId: number) => void

    • ProcessID

      число

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

Возвраты

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

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

getProcessInfo()

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

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

Параметры

  • ProcessIds

    число | число[]

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

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

    булев

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

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

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

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

    (processes: object) => void

    • процессы

      объект

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

Возвраты

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

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

terminate()

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

Завершает указанный процесс рендеринга. Эквивалентно посещению 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

    • процессы

      объект