chrome.processes

Opis

Użyj interfejsu API chrome.processes, aby wchodzić w interakcje z procesami przeglądarki.

Uprawnienia

processes

Dostępność

Kanał dla programistów

Typy

Cache

Właściwości

  • liveSize

    liczba

    Wykorzystywana część pamięci podręcznej (w bajtach).

  • rozmiar

    liczba

    Rozmiar pamięci podręcznej (w bajtach).

Process

Właściwości

  • cpu

    numer opcjonalny

    Najnowsze pomiary wykorzystania procesora przez proces, wyrażone jako odsetek 1 rdzenia procesora używanego przez wszystkie wątki procesu. Daje to wartość od 0 do CpuInfo.numOfProcessors*100, która może przekraczać 100% w przypadku procesów wielowątkowych. Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • cssCache

    Pamięć podręczna opcjonalna

    Najnowsze informacje o pamięci podręcznej usługi porównywania cen dotyczącej procesu. Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • id

    liczba

    Unikalny identyfikator procesu udostępniany przez przeglądarkę.

  • imageCache

    Pamięć podręczna opcjonalna

    Najnowsze informacje o pamięci podręcznej obrazów dla procesu. Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • jsMemoryAllocated

    numer opcjonalny

    Najnowsze pomiary przydzielonej pamięci JavaScript w procesie w bajtach. Dostępny tylko podczas otrzymywania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • jsMemoryUsed

    numer opcjonalny

    Najnowsze pomiary wykorzystania pamięci JavaScript przez proces (w bajtach). Dostępny tylko wtedy, gdy obiekt jest odbierany jako część wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • naclDebugPort

    liczba

    Port debugowania procesów klienta natywnego. Zero w przypadku innych typów procesów i procesów NaCl, w których nie jest włączone debugowanie.

  • sieć

    numer opcjonalny

    Najnowszy pomiar wykorzystania sieci przez proces w bajtach na sekundę. Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • osProcessId

    liczba

    Identyfikator procesu dostarczony przez system operacyjny.

  • privateMemory

    numer opcjonalny

    Najnowsze pomiary wykorzystania prywatnej pamięci przez proces (w bajtach). Dostępne tylko podczas otrzymywania obiektu w ramach wywołania zwrotnego z metody onUpdatedWithMemory lub getProcessInfo z flagą includeMemory.

  • profil

    ciąg znaków

    Profil, z którym jest powiązany proces.

  • scriptCache

    Pamięć podręczna opcjonalna

    Najnowsze informacje o pamięci podręcznej skryptu dotyczącej procesu. Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • sqliteMemory

    numer opcjonalny

    Najnowsze pomiary wykorzystania pamięci SQLite przez proces (w bajtach). Dostępny tylko podczas odbierania obiektu w ramach wywołania zwrotnego z metody onUpdated lub onUpdatedWithMemory.

  • zadania

    TaskInfo[]

    Tablica TaskInfos zawierająca informacje o zadaniach wykonywanych w ramach tego procesu.

  • Typ procesu.

ProcessType

Typy procesów przeglądarki.

Typ wyliczeniowy

„browser”

„renderer”

„extension”

„notification”

„plugin”

"worker"

"nacl"

"service_worker"
Nieaktualne, nigdy nie zostanie zwrócone.

„utility”

„gpu”

"inne"

TaskInfo

Właściwości

  • tabId

    numer opcjonalny

    Opcjonalny identyfikator karty, jeśli to zadanie reprezentuje kartę uruchamianą w procesie renderowania.

  • tytuł

    ciąg znaków

    Tytuł zadania.

Metody

getProcessIdForTab()

Obietnice 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

Zwraca identyfikator procesu renderowania dla określonej karty.

Parametry

  • tabId

    liczba

    Identyfikator karty, dla której ma zostać zwrócony identyfikator procesu renderowania.

  • callback

    function opcjonalny

    Parametr callback ma postać:

    (processId: number) => void

    • processId

      liczba

      Identyfikator procesu renderowania karty.

Zwroty

  • Obietnice<number>

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getProcessInfo()

Obietnice 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

Pobiera informacje o procesie dla każdego podanego identyfikatora procesu.

Parametry

  • processIds

    liczba | liczba[]

    Lista identyfikatorów procesów lub pojedynczy identyfikator procesu, dla którego mają zostać zwrócone informacje o procesie. Pusty element oznacza, że wymagane są wszystkie procesy.

  • includeMemory

    Wartość logiczna

    Prawda, jeśli wymagane jest szczegółowe wykorzystanie pamięci. Pamiętaj, że zbieranie informacji o wykorzystaniu pamięci powoduje dodatkowe obciążenie procesora i powinno być wykonywane tylko wtedy, gdy jest to konieczne.

  • callback

    function opcjonalny

    Parametr callback ma postać:

    (processes: object) => void

    • procesy

      obiekt

      Słownik obiektów Process dla każdego żądanego procesu, który jest aktywnym procesem podrzędnym bieżącego procesu przeglądarki, posortowany według identyfikatora procesu. Dane wymagające agregacji w czasie nie będą wypełniane w każdym obiekcie Process.

Zwroty

  • Obietkw<object>

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

terminate()

Obietnice 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

Zatrzymuje wskazany proces mechanizmu renderowania. To działanie jest równoznaczne z otwarciem strony about:crash, ale bez zmiany adresu URL karty.

Parametry

  • processId

    liczba

    Identyfikator procesu do zakończenia.

  • callback

    function opcjonalny

    Parametr callback ma postać:

    (didTerminate: boolean) => void

    • didTerminate

      Wartość logiczna

      Wartość true, jeśli proces został zamknięty pomyślnie, a w przeciwnym razie – false.

Zwroty

  • Promise<boolean>

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onCreated

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

Wywoływany za każdym razem, gdy tworzony jest proces. Udostępnia odpowiadający obiekt Process.

Parametry

  • callback

    funkcja

    Parametr callback ma postać:

    (process: Process) => void

onExited

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

Wywoływany za każdym razem, gdy proces jest zamykany. Określa typ zakończenia.

Parametry

  • callback

    funkcja

    Parametr callback ma postać:

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

    • processId

      liczba

    • exitType

      liczba

    • exitCode

      liczba

onUnresponsive

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

Wywoływany za każdym razem, gdy proces przestaje odpowiadać. Przekazuje odpowiadający obiekt Process.

Parametry

  • callback

    funkcja

    Parametr callback ma postać:

    (process: Process) => void

onUpdated

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

Wywoływany za każdym razem, gdy Menedżer zadań aktualizuje statystyki procesu, przekazując słownik zaktualizowanych obiektów Process, posortowany według identyfikatora procesu.

Parametry

  • callback

    funkcja

    Parametr callback ma postać:

    (processes: object) => void

    • procesy

      obiekt

onUpdatedWithMemory

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

Wywoływany za każdym razem, gdy Menedżer zadań aktualizuje statystyki procesu, przekazując słownik zaktualizowanych obiektów Process, posortowanych według identyfikatora procesu. To samo co onUpdate, z dodatkiem szczegółów wykorzystania pamięci, które są zawarte w każdym obiekcie Process. Pamiętaj, że zbieranie informacji o wykorzystaniu pamięci powoduje dodatkowe obciążenie procesora i powinno być wykonywane tylko wtedy, gdy jest to konieczne.

Parametry

  • callback

    funkcja

    Parametr callback ma postać:

    (processes: object) => void

    • procesy

      obiekt