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

Описание

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

Разрешения

processes

Доступность

Канал для разработчиков

Типы

Cache

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

  • liveSize

    число

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

  • размер

    число

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

Process

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

  • Процессор

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

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

  • cssCache

    Кэш опционально

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

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

    число

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

  • Кэш изображения

    Кэш опционально

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

  • jsMemoryAllocated

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

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

  • jsMemoryUsed

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

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

  • naclDebugPort

    число

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

  • сеть

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

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

  • оспроцессид

    число

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

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

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

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

  • профиль

    нить

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

  • скриптКэш

    Кэш опционально

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

  • sqliteMemory

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

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

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

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

ProcessType

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

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

"браузер"

"рендерер"

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

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

"плагин"

"работник"

"накл"

"service_worker"

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

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

"другой"

TaskInfo

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

  • идентификатор табуляции

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

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

  • заголовок

    нить

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

Методы

getProcessIdForTab()

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

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

Параметры

  • идентификатор табуляции

    число

    Идентификатор вкладки, для которой должен быть возвращен идентификатор процесса средства визуализации.

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

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

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

    (processId: number) => void

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

      число

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

Возврат

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

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

getProcessInfo()

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

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

Параметры

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

    номер | число[]

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

  • includeMemory

    логическое значение

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

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

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

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

    (processes: object) => void

    • процессы

      объект

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

Возврат

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

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

terminate()

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

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

Параметры

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

    число

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

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

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

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

    (didTerminate: boolean) => void

    • сделалЗавершить

      логическое значение

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

Возврат

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

    Промисы поддерживаются в Манифесте 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

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

      число

    • тип выхода

      число

    • код выхода

      число

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, с добавлением сведений об использовании памяти, включенных в каждый объект Process. Обратите внимание, что сбор информации об использовании памяти требует дополнительной загрузки ЦП и его следует прослушивать только при необходимости.

Параметры

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

    функция

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

    (processes: object) => void

    • процессы

      объект