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

Описание

Используйте 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.

  • osProcessId

    число

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

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

    число необязательно

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

  • профиль

    нить

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

  • scriptCache

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

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

  • sqliteMemory

    число необязательно

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

  • задачи

    TaskInfo []

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

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

ProcessType

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

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

"браузер"

"рендерер"

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

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

"плагин"

«рабочий»
Устарело, возврату не подлежит.

"nacl"

"service_worker"
Устарело, возврату не подлежит.

«полезность»

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

"другой"

TaskInfo

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

  • tabId

    число необязательно

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

  • заголовок

    нить

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

Методы

getProcessIdForTab()

chrome.processes.getProcessIdForTab(
  tabId: number,
): Promise<number>

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

Параметры

  • tabId

    число

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

Возвраты

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

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

getProcessInfo()

chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
): Promise<object>

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

Параметры

  • processIds

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

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

  • includeMemory

    логический

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

Возвраты

  • Promise<object>

    Функция обратного вызова, вызываемая при сборе информации о процессе.

terminate()

chrome.processes.terminate(
  processId: number,
): Promise<boolean>

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

Параметры

  • processId

    число

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

Возвраты

  • Promise<boolean>

    Перезвоним, чтобы сообщить о статусе увольнения.

События

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

      число

    • exitType

      число

    • код выхода

      число

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,
)

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

Параметры

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

    функция

    Параметр callback выглядит следующим образом: 

    (processes: object) => void

    • процессы

      объект