chrome.processes

Opis

Użyj interfejsu chrome.processes API, aby wchodzić w interakcje 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

    number opcjonalny

    Najnowszy pomiar wykorzystania procesora przez proces wyrażony jako procent pojedynczego rdzenia procesora używanego łącznie przez wszystkie wątki procesu. Daje to wartość od zera do CpuInfo.numOfProcessors*100, która w przypadku procesów wielowątkowych może przekraczać 100%. Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • cssCache

    Cache opcjonalny

    Najnowsze informacje o pamięci podręcznej CSS dla tego procesu. Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • id

    liczba

    Unikalny identyfikator procesu podany przez przeglądarkę.

  • imageCache

    Cache opcjonalny

    Najnowsze informacje o pamięci podręcznej obrazów dla procesu. Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • jsMemoryAllocated

    number opcjonalny

    Najnowszy pomiar pamięci przydzielonej przez JavaScript w procesie (w bajtach). Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • jsMemoryUsed

    number opcjonalny

    Najnowszy pomiar wykorzystania pamięci JavaScript przez proces (w bajtach). Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • naclDebugPort

    liczba

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

  • sieć

    number opcjonalny

    Najnowszy pomiar wykorzystania sieci przez proces (w bajtach na sekundę). Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • osProcessId

    liczba

    Identyfikator procesu podany przez system operacyjny.

  • privateMemory

    number opcjonalny

    Najnowszy pomiar wykorzystania pamięci prywatnej przez proces (w bajtach). Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdatedWithMemory lub getProcessInfo z ustawioną flagą includeMemory.

  • profil

    ciąg znaków

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

  • scriptCache

    Cache opcjonalny

    Najnowsze informacje o pamięci podręcznej skryptu dla procesu. Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • sqliteMemory

    number opcjonalny

    Najnowszy pomiar wykorzystania pamięci SQLite przez proces (w bajtach). Dostępne tylko wtedy, gdy obiekt jest odbierany w ramach wywołania zwrotnego z funkcji onUpdated lub onUpdatedWithMemory.

  • zadania,

    TaskInfo[]

    Tablica TaskInfo reprezentująca zadania uruchomione w tym procesie.

  • Typ procesu.

ProcessType

Typy procesów przeglądarki.

Typ wyliczeniowy

„browser”

„renderer”

„extension”

„notification”

„plugin”

„worker”
Przestarzałe, nigdy nie będzie zwracane.

„nacl”

„service_worker”
Przestarzałe, nigdy nie będzie zwracane.

„utility”

„gpu”

„other”

TaskInfo

Właściwości

  • tabId

    number opcjonalny

    Opcjonalny identyfikator karty, jeśli to zadanie reprezentuje kartę działającą w procesie renderowania.

  • tytuł

    ciąg znaków

    Tytuł zadania.

Metody

getProcessIdForTab()

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

Zwraca identyfikator procesu renderowania dla określonej karty.

Parametry

  • tabId

    liczba

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (processId: number) => void

    • processId

      liczba

      Identyfikator procesu renderowania karty.

Zwroty

  • Promise<number>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getProcessInfo()

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

Pobiera informacje o procesie dla każdego określonego 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. Pusta lista oznacza, że żądane są wszystkie procesy.

  • includeMemory

    Wartość logiczna

    Wartość Prawda, jeśli wymagane jest szczegółowe wykorzystanie pamięci. Pamiętaj, że zbieranie informacji o wykorzystaniu pamięci powoduje dodatkowe wykorzystanie procesora i należy je wykonywać tylko w razie potrzeby.

  • callback

    funkcja opcjonalna

    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. Dane wymagające agregacji w czasie nie będą wypełniane w poszczególnych obiektach procesu.

Zwroty

  • Promise<object>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

terminate()

Obietnica 
chrome.processes.terminate(
  processId: number,
  callback?: function,
): Promise<boolean>

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

Parametry

  • processId

    liczba

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (didTerminate: boolean) => void

    • didTerminate

      Wartość logiczna

      Wartość true, jeśli zakończenie procesu się powiodło. W przeciwnym razie wartość false.

Zwroty

  • Promise<boolean>

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onCreated

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

Wywoływane za każdym razem, gdy tworzony jest proces, i udostępnia odpowiedni obiekt Process.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (process: Process) => void

onExited

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

Wywoływane za każdym razem, gdy proces jest kończony, i podaje typ zakończenia.

Parametry

  • callback

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

Wywoływane za każdym razem, gdy proces przestaje odpowiadać, i zawiera odpowiedni obiekt Process.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (process: Process) => void

onUpdated

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

Wywoływane za każdym razem, gdy Menedżer zadań aktualizuje statystyki procesów. Zawiera słownik zaktualizowanych obiektów Process indeksowanych według identyfikatora procesu.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (processes: object) => void

    • procesy,

      obiekt

onUpdatedWithMemory

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

Wywoływane za każdym razem, gdy Menedżer zadań aktualizuje statystyki procesów. Zawiera słownik zaktualizowanych obiektów Process indeksowanych według identyfikatora procesu. Identyczna z funkcją onUpdate, z tym że każdy obiekt Process zawiera szczegółowe informacje o wykorzystaniu pamięci. Pamiętaj, że zbieranie informacji o wykorzystaniu pamięci powoduje dodatkowe obciążenie procesora i należy je włączać tylko wtedy, gdy jest to konieczne.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (processes: object) => void

    • procesy,

      obiekt