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

    Wykorzystana 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 odsetek wykorzystania jednego rdzenia procesora w całości, we wszystkich wątkach tego procesu. Daje to wartość od 0 do wartości CpuInfo.numOfProcessors*100, która może przekroczyć 100% w przypadku procesów wielowątkowych. Opcja dostępna tylko w przypadku odbierania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • cssCache

    Pamięć podręczna opcjonalnie

    Najnowsze informacje o pamięci podręcznej CSS dla tego procesu. Opcja dostępna tylko w przypadku odbierania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • id

    Liczba

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

  • imageCache

    Pamięć podręczna opcjonalnie

    Najnowsze informacje o pamięci podręcznej obrazów dla tego procesu. Opcja dostępna tylko w przypadku odbierania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • jsMemoryAllocated

    Liczba opcjonalnie

    Ostatni pomiar (w bajtach) procesu przydzielonego przez JavaScript. Opcja dostępna tylko w przypadku odbierania obiektu w ramach wywołania zwrotnego z onUpdated lub onUpdatedWithMemory.

  • jsMemoryUsed

    Liczba opcjonalnie

    Ostatni pomiar używanej pamięci JavaScript procesu (w bajtach). Opcja dostępna tylko w przypadku odbierania 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 oraz procesów NaCl, które nie mają włączonego debugowania.

  • sieć

    Liczba opcjonalnie

    Ostatni pomiar wykorzystania sieci przez proces (w bajtach na sekundę). Opcja dostępna tylko w przypadku odbierania 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 w procesie (w bajtach). Dostępne tylko w przypadku odbierania obiektu w ramach wywołania zwrotnego z onUpdatedWithMemory lub getProcessInfo z flagą includeMemory.

  • profil

    string,

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

  • scriptCache

    Pamięć podręczna opcjonalnie

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

  • sqliteMemory

    Liczba opcjonalnie

    Ostatni pomiar wykorzystania pamięci SQLite w procesie (w bajtach). Opcja dostępna tylko w przypadku odbierania 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 przeglądarki.

Enum

"notification"

"nacl"

"service_worker"

"utility"

"gpu"

TaskInfo

Właściwości

  • tabId

    Liczba opcjonalnie

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

  • title

    string,

    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, dla której ma zostać zwrócony identyfikator procesu renderowania.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (processId: number)=>void

    • processId

      Liczba

      Identyfikator procesu mechanizmu renderowania karty.

Akcje powrotne

  • Obietnica<number>

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika 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 podanego identyfikatora procesu.

Parametry

  • processIds

    liczba|liczba[]

    Lista identyfikatorów procesów lub pojedynczy identyfikator procesu, dla którego mają zostać zwrócone informacje. Pusta lista oznacza, że żądane są wszystkie procesy.

  • includeMemory

    boolean

    Prawda, jeśli wymagane jest szczegółowe wykorzystanie pamięci. Zbieranie informacji o wykorzystaniu pamięci wiąże się z dodatkowym wykorzystaniem procesora, dlatego zapytania należy wysyłać tylko wtedy, gdy są potrzebne.

  • wywołanie zwrotne

    funkcja opcjonalnie

    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 indeksowanym według identyfikatora procesu. Wskaźniki wymagające agregacji w czasie nie będą wypełniane w przypadku każdego obiektu Process.

Akcje powrotne

  • Promise<object>

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

terminate()

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

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

Parametry

  • processId

    Liczba

    Identyfikator procesu do zakończenia.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      Wartość prawda, jeśli proces został zakończony pomyślnie, albo „false” (fałsz), jeśli jest inaczej.

Akcje powrotne

  • Promise<boolean>

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onCreated

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

Uruchamiane przy każdym utworzeniu procesu, dostarczając obiekt procesu współbieżnego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (process: Process)=>void

onExited

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

Uruchamiane przy każdym zakończeniu procesu. 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

    • exitCode

      Liczba

onUnresponsive

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

Uruchamiane za każdym razem, gdy proces nie odpowiada, dostarczając obiekt procesu współbieżnego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (process: Process)=>void

onUpdated

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

Uruchamiane za każdym razem, gdy Menedżer zadań aktualizuje statystyki 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,
)

Uruchamiane za każdym razem, gdy Menedżer zadań aktualizuje statystyki procesów, udostępniając słownik zaktualizowanych obiektów procesów indeksowanych według identyfikatora procesu. Identyczne jak w przypadku onUpdate, z dodanym szczegółami wykorzystania pamięci w każdym obiekcie Process. Pamiętaj, że zbieranie informacji o wykorzystaniu pamięci wiąże się z dodatkowym wykorzystaniem procesora i należy ich nasłuchiwać tylko wtedy, gdy jest to potrzebne.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (processes: object)=>void

    • procesy

      obiekt