chrome.processes

Beschreibung

Verwenden Sie die chrome.processes API, um mit den Prozessen des Browsers zu interagieren.

Berechtigungen

processes

Verfügbarkeit

Dev-Channel

Typen

Cache

Attribute

  • liveSize

    Zahl

    Der Teil des Cache, der genutzt wird, in Byte.

  • Größe

    Zahl

    Die Größe des Cache in Byte.

Process

Attribute

  • cpu

    number optional

    Die letzte Messung der CPU-Nutzung des Prozesses, ausgedrückt als Prozentsatz eines einzelnen CPU-Kerns, der insgesamt von allen Threads des Prozesses verwendet wird. Das ergibt einen Wert zwischen 0 und CpuInfo.numOfProcessors*100, der bei Multithread-Prozessen 100% überschreiten kann. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • cssCache

    Cache optional

    Die neuesten Informationen zum CSS-Cache für den Prozess. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • id

    Zahl

    Eindeutige ID des Prozesses, die vom Browser bereitgestellt wird.

  • imageCache

    Cache optional

    Die neuesten Informationen zum Bildcache für den Prozess. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • jsMemoryAllocated

    number optional

    Die letzte Messung des vom Prozess zugewiesenen JavaScript-Arbeitsspeichers in Byte. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • jsMemoryUsed

    number optional

    Die letzte Messung des vom Prozess verwendeten JavaScript-Arbeitsspeichers in Byte. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • naclDebugPort

    Zahl

    Der Debugging-Port für Native Client-Prozesse. Null für andere Prozesstypen und für NaCl-Prozesse, bei denen das Debugging nicht aktiviert ist.

  • Netzwerk

    number optional

    Die letzte Messung der Netzwerkauslastung des Prozesses in Byte pro Sekunde. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • osProcessId

    Zahl

    Die ID des Prozesses, wie vom Betriebssystem bereitgestellt.

  • privateMemory

    number optional

    Die letzte Messung der privaten Arbeitsspeichernutzung des Prozesses in Byte. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von „onUpdatedWithMemory“ oder „getProcessInfo“ mit dem Flag „includeMemory“ empfangen wird.

  • Profil

    String

    Das Profil, dem der Prozess zugeordnet ist.

  • scriptCache

    Cache optional

    Die aktuellen Informationen zum Skriptcache für den Prozess. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • sqliteMemory

    number optional

    Die letzte Messung der SQLite-Arbeitsspeichernutzung des Prozesses in Byte. Nur verfügbar, wenn das Objekt als Teil eines Rückrufs von onUpdated oder onUpdatedWithMemory empfangen wird.

  • Aufgaben

    TaskInfo[]

    Array von TaskInfos, das die in diesem Prozess ausgeführten Aufgaben darstellt.

  • Die Art des Prozesses.

ProcessType

Die Arten der Browserprozesse.

Enum

"browser"

"renderer"

"extension"

„Benachrichtigung“

"plugin"

„worker“
Veraltet, wird nie zurückgegeben.

"nacl"

„service_worker“
Veraltet, wird nie zurückgegeben.

„utility“

"gpu"

"other"

TaskInfo

Attribute

  • tabId

    number optional

    Optionale Tab-ID, wenn diese Aufgabe einen Tab darstellt, der in einem Renderer-Prozess ausgeführt wird.

  • Titel

    String

    Der Titel der Aufgabe.

Methoden

getProcessIdForTab()

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

Gibt die ID des Renderer-Prozesses für den angegebenen Tab zurück.

Parameter

  • tabId

    Zahl

    Die ID des Tabs, für den die Prozess-ID des Renderers zurückgegeben werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (processId: number) => void

    • processId

      Zahl

      Prozess-ID des Renderer-Prozesses des Tabs.

Ausgabe

  • Promise<number>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getProcessInfo()

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

Ruft die Prozessinformationen für jede angegebene Prozess-ID ab.

Parameter

  • processIds

    number | number[]

    Die Liste der Prozess-IDs oder die einzelne Prozess-ID, für die die Prozessinformationen zurückgegeben werden sollen. Eine leere Liste gibt an, dass alle Prozesse angefordert werden.

  • includeMemory

    boolean

    „True“, wenn eine detaillierte Arbeitsspeichernutzung erforderlich ist. Das Erfassen von Informationen zur Speichernutzung führt zu einer zusätzlichen CPU-Auslastung und sollte nur bei Bedarf erfolgen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (processes: object) => void

    • Verfahren

      Objekt

      Ein Dictionary mit Process-Objekten für jeden angeforderten Prozess, der ein aktiver untergeordneter Prozess des aktuellen Browserprozesses ist, indexiert nach Prozess-ID. Messwerte, die eine Aggregation über die Zeit erfordern, werden nicht in jedem Prozessobjekt eingefügt.

Ausgabe

  • Promise<object>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

terminate()

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

Beendet den angegebenen Renderer-Prozess. Entspricht dem Aufrufen von „about:crash“, ohne die URL des Tabs zu ändern.

Parameter

  • processId

    Zahl

    Die ID des zu beendenden Prozesses.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (didTerminate: boolean) => void

    • didTerminate

      boolean

      „True“, wenn das Beenden des Prozesses erfolgreich war, andernfalls „false“.

Ausgabe

  • Promise<boolean>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onCreated

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

Wird jedes Mal ausgelöst, wenn ein Prozess erstellt wird, und stellt das entsprechende Process-Objekt bereit.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (process: Process) => void

onExited

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

Wird jedes Mal ausgelöst, wenn ein Prozess beendet wird. Gibt den Typ des Beendigungsvorgangs an.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • processId

      Zahl

    • exitType

      Zahl

    • exitCode

      Zahl

onUnresponsive

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

Wird jedes Mal ausgelöst, wenn ein Prozess nicht mehr reagiert. Das entsprechende Process-Objekt wird bereitgestellt.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (process: Process) => void

onUpdated

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

Wird jedes Mal ausgelöst, wenn der Task-Manager seine Prozessstatistiken aktualisiert. Das Dictionary der aktualisierten Prozessobjekte wird nach Prozess-ID indexiert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processes: object) => void

    • Verfahren

      Objekt

onUpdatedWithMemory

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

Wird jedes Mal ausgelöst, wenn der Task-Manager seine Prozessstatistiken aktualisiert. Das Dictionary der aktualisierten Prozessobjekte wird nach Prozess-ID indexiert. Identisch mit „onUpdate“, mit dem Unterschied, dass jedes Process-Objekt Details zur Speichernutzung enthält. Das Erfassen von Informationen zur Speichernutzung führt zu einer zusätzlichen CPU-Auslastung und sollte nur bei Bedarf erfolgen.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processes: object) => void

    • Verfahren

      Objekt