browser.processes

Описание

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

Разрешения

processes

Доступность

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

Типы

Cache

Свойства

  • liveSize

    число

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

  • размер

    число

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

Process

Свойства

  • ЦП

    number (необязательно)

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

  • cssCache

    Cache необязательно

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

  • id

    число

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

  • imageCache

    Cache необязательно

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

  • jsMemoryAllocated

    number (необязательно)

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

  • jsMemoryUsed

    number (необязательно)

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

  • naclDebugPort

    число

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

  • телесеть : телеканал

    number (необязательно)

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

  • osProcessId

    число

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

  • privateMemory

    number (необязательно)

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

  • профиль

    string

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

  • scriptCache

    Cache необязательно

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

  • sqliteMemory

    number (необязательно)

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

  • tasks

    TaskInfo[]

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

  • тип

    ProcessType

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

ProcessType

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

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

"browser"

"renderer"

"extension"

"notification"

"plugin"

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

"nacl"

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

"utility"

"gpu"

"other"

TaskInfo

Свойства

  • tabId

    number (необязательно)

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

  • название

    string

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

Методы

getProcessIdForTab()

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

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

Параметры

  • tabId

    число

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

Возвраты

  • Promise<number>

    Обратный вызов для возврата идентификатора процесса визуализации вкладки.

getProcessInfo()

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

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

Параметры

  • processIds

    number | number[]

    Идентификатор процесса или список идентификаторов, для которых нужно получить информацию. Если список пуст, запрашиваются все процессы.

  • includeMemory

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

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

Возвраты

  • Promise<object>

    Обратный вызов, который выполняется при сборе информации о процессах.

terminate()

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

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

Параметры

  • processId

    число

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

Возвраты

  • Promise<boolean>

    Обратный вызов для сообщения о статусе завершения.

События

onCreated

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

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

Параметры

  • обратный вызов

    function

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

    (process: Process) => void

onExited

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

Срабатывает каждый раз, когда процесс завершается, и предоставляет тип выхода.

Параметры

  • обратный вызов

    function

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

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

    • processId

      число

    • exitType

      число

    • exitCode

      число

onUnresponsive

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

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

Параметры

  • обратный вызов

    function

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

    (process: Process) => void

onUpdated

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

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

Параметры

  • обратный вызов

    function

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

    (processes: object) => void

    • процессы

      Объект

onUpdatedWithMemory

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

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

Параметры

  • обратный вызов

    function

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

    (processes: object) => void

    • процессы

      Объект