chrome.processes

Opis

Interfejs API chrome.processes umożliwia interakcję z procesami przeglądarki.

Uprawnienia

processes

Dostępność

Wersja deweloperska .

Typy

Cache

Właściwości

  • liveSize

    liczba

    Używana część pamięci podręcznej (w bajtach).

  • rozmiar

    liczba

    Rozmiar pamięci podręcznej w bajtach.

Process

Właściwości

  • cpu

    liczba opcjonalnie

    Ostatni pomiar wykorzystania procesora w procesie, wyrażony jako procent łącznego użycia 1 rdzenia procesora przez wszystkie wątki procesu. Zwraca wartość od 0 do wartości CpuInfo.numOfProcessors*100, która może przekraczać 100% w procesach wielowątkowych. Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • cssCache

    Pamięć podręczna opcjonalnie

    Najnowsze informacje o pamięci podręcznej usługi porównywania cen dla tego procesu. Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • id

    liczba

    Unikalny identyfikator procesu dostarczony przez przeglądarkę.

  • imageCache

    Pamięć podręczna opcjonalnie

    Najnowsze informacje o pamięci podręcznej zdjęć na potrzeby tego procesu. Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • jsMemoryAllocated

    liczba opcjonalnie

    Ostatni pomiar pamięci przydzielonej dla języka JavaScript (w bajtach). Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • jsMemoryUsed

    liczba opcjonalnie

    Ostatni pomiar używanej pamięci JavaScriptu podczas procesu (w bajtach). Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • naclDebugPort

    liczba

    Port debugowania procesów klienta natywnego. Zero w przypadku innych typów procesów i procesów NaCl, które nie mają włączonego debugowania.

  • sieć

    liczba opcjonalnie

    Ostatni pomiar wykorzystania sieci w procesie (w bajtach na sekundę). Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • osProcessId

    liczba

    Identyfikator procesu podany przez system operacyjny.

  • privateMemory

    liczba opcjonalnie

    Ostatni pomiar wykorzystania pamięci prywatnej procesu (w bajtach). Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdatedWithMemory lub getProcessInfo z flagą includeMemory.

  • profil

    ciąg znaków

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

  • scriptCache

    Pamięć podręczna opcjonalnie

    Najnowsze informacje o pamięci podręcznej skryptu na potrzeby tego procesu. Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • sqliteMemory

    liczba opcjonalnie

    Ostatni pomiar wykorzystania pamięci SQLite przez proces (w bajtach). Opcja dostępna tylko w przypadku otrzymania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • zadania

    TaskInfo[]

    Tablica TaskInfos reprezentująca zadania uruchomione w tym procesie.

  • Typ procesu.

ProcessType

Typy procesów wykonywanych przez przeglądarkę.

Typ wyliczeniowy

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"

"utility"

"gpu"

"inna"

TaskInfo

Właściwości

  • tabId

    liczba opcjonalnie

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

  • tytuł

    ciąg znaków

    Tytuł zadania.

Metody

getProcessIdForTab()

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

Zwraca identyfikator procesu renderowania dla określonej karty.

Parametry

  • tabId

    liczba

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (processId: number) => void
    .

    • processId

      liczba

      Identyfikator procesu mechanizmu renderowania karty.

Zwroty

  • Promise<number>

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

getProcessInfo()

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

Pobiera informacje o procesie dla każdego określonego identyfikatora procesu.

Parametry

  • processIds

    liczba | liczba[]

    Lista identyfikatorów procesów lub identyfikatorów pojedynczych procesów, dla których mają być zwracane informacje o procesie. Pusta lista oznacza, że żądane są wszystkie procesy.

  • includeMemory

    wartość logiczna

    Prawda, jeśli wymagane jest szczegółowe wykorzystanie pamięci. Uwaga: zbieranie informacji o wykorzystaniu pamięci wiąże się z dodatkowym wykorzystaniem procesora i można je wysyłać tylko wtedy, gdy jest to konieczne.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (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, indeksowany według identyfikatora procesu. Wskaźniki wymagające agregacji w czasie nie będą wypełniane w poszczególnych obiektach Process.

Zwroty

  • Promise<object>

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

terminate()

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

Zatrzymuje określony proces renderowania. Odpowiednik wizyty about:crash, ale bez zmiany adresu URL karty.

Parametry

  • processId

    liczba

    Identyfikator procesu, który ma zostać zakończony.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (didTerminate: boolean) => void
    .

    • didTerminate

      wartość logiczna

      Wartość true, jeśli zakończenie procesu zakończyło się powodzeniem, a wartość fałsz – w przeciwnym razie.

Zwroty

  • Promise<boolean>

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onCreated

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

Uruchamiany za każdym razem, gdy proces jest tworzony, i dostarcza obiekt odpowiadający obiektowi procesu.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (process: Process) => void
    .

onExited

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

Uruchamiany po każdym zakończeniu procesu i podaje typ wyjścia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

    • processId

      liczba

    • exitType

      liczba

    • Kod wyjścia

      liczba

onUnresponsive

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

Uruchamiany za każdym razem, gdy proces przestanie odpowiadać, i dostarcza obiekt odpowiadający obiektowi procesu.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (process: Process) => void
    .

onUpdated

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

Uruchamiany za każdym razem, gdy Menedżer zadań aktualizuje statystyki swoich procesów, udostępniając słownik zaktualizowanych obiektów procesów indeksowanych według identyfikatora procesu.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (processes: object) => void
    .

    • procesy

      Obiekt

onUpdatedWithMemory

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

Uruchamiany za każdym razem, gdy Menedżer zadań aktualizuje statystyki swoich procesów, udostępniając słownik zaktualizowanych obiektów procesów indeksowanych według identyfikatora procesu. Identyczna z parametrem onUpdate, z dodatkowymi informacjami o wykorzystaniu pamięci dołączonym do każdego obiektu Process. Uwaga: zbieranie informacji o wykorzystaniu pamięci wiąże się z dodatkowym wykorzystaniem procesora i należy nasłuchiwać tylko wtedy, gdy jest to konieczne.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (processes: object) => void
    .

    • procesy

      Obiekt