chrome.processes

Beschreibung

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

Berechtigungen

processes

Verfügbarkeit

Entwicklerversion

Typen

Cache

Attribute

  • liveSize

    Zahl

    Der genutzte Teil des Cache in Byte.

  • Größe

    Zahl

    Die Größe des Cache in Byte.

Process

Attribute

  • cpu

    Nummer optional

    Die letzte Messung der CPU-Auslastung des Prozesses, ausgedrückt als Prozentsatz eines insgesamt verwendeten CPU-Kerns durch alle Threads des Prozesses. Dies ergibt einen Wert von null bis CpuInfo.numOfProcessors*100, der in Multithread-Prozessen 100% überschreiten kann. Nur verfügbar, wenn das Objekt als Teil eines Callbacks 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 Callbacks von onUpdated oder onUpdatedWithMemory empfangen wird.

  • id

    Zahl

    Eindeutige ID des Prozesses, die vom Browser bereitgestellt wird.

  • imageCache

    Cache optional

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

  • jsMemoryAllocated

    Nummer optional

    Letzte Messung des von JavaScript zugewiesenen Arbeitsspeichers in Byte. Nur verfügbar, wenn das Objekt als Teil eines Callbacks von onUpdated oder onUpdatedWithMemory empfangen wird.

  • jsMemoryUsed

    Nummer optional

    Letzte Messung des verwendeten JavaScript-Speichers in Byte. Nur verfügbar, wenn das Objekt als Teil eines Callbacks von onUpdated oder onUpdatedWithMemory empfangen wird.

  • naclDebugPort

    Zahl

    Der Debugging-Port für Native Client-Prozesse. Null für andere Prozesstypen und NaCl-Prozesse, für die kein Debugging aktiviert ist.

  • Netzwerk

    Nummer optional

    Die letzte Messung der Prozessnetzwerknutzung in Byte pro Sekunde. Nur verfügbar, wenn das Objekt als Teil eines Callbacks von onUpdated oder onUpdatedWithMemory empfangen wird.

  • osProcessId

    Zahl

    Die ID des Prozesses, die vom Betriebssystem angegeben wird.

  • privateMemory

    Nummer optional

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

  • Profil

    String

    Das Profil, dem der Prozess zugeordnet ist.

  • scriptCache

    Cache optional

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

  • sqliteMemory

    Nummer optional

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

  • tasks

    TaskInfo[]

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

  • Die Art des Prozesses.

ProcessType

Die Typen der Browserprozesse.

Enum

"plugin"

"nacl"

"service_worker"

"gpu"

TaskInfo

Attribute

  • tabId

    Nummer optional

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

  • Titel

    String

    Der Titel der Aufgabe.

Methoden

getProcessIdForTab()

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

Gibt die ID des Rendererprozesses für den angegebenen Tab zurück

Parameters

  • tabId

    Zahl

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (processId: number)=>void

    • processId

      Zahl

      Prozess-ID des Rendererprozesses des Tabs

Rückgaben

  • Versprechen<Zahl>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getProcessInfo()

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

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

Parameters

  • processIds

    Zahl|Zahl[]

    Die Liste der Prozess-IDs oder der einzelnen Prozess-IDs, für die die Prozessinformationen zurückgegeben werden sollen. Bei einer leeren Liste werden alle Prozesse angefordert.

  • includeMemory

    boolean

    True, wenn detaillierte Arbeitsspeichernutzung erforderlich ist. Hinweis: Das Erfassen von Informationen zur Arbeitsspeichernutzung verursacht eine zusätzliche CPU-Auslastung und sollte nur bei Bedarf abgefragt werden.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (processes: object)=>void

    • Verfahren

      Objekt

      Ein Wörterbuch mit Process-Objekten für jeden angeforderten Prozess, bei dem es sich um einen Live-Unterprozess des aktuellen Browserprozesses handelt, der nach Prozess-ID indexiert ist. Messwerte, die eine Aggregation im Zeitverlauf erfordern, werden nicht in jedes Process-Objekt eingefügt.

Rückgaben

  • Promise<object>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

terminate()

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

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

Parameters

  • 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“.

Rückgaben

  • Promise<boolean>

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

onCreated

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

Wird bei jeder Erstellung eines Prozesses ausgelöst und das entsprechende Process-Objekt bereitgestellt.

Parameters

  • 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, unter Angabe des Exit-Typs.

Parameters

  • 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 und das entsprechende Process-Objekt bereitgestellt wird

Parameters

  • 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 und das Wörterbuch der aktualisierten Prozessobjekte bereitstellt, die nach Prozess-ID indexiert sind.

Parameters

  • 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 und das Wörterbuch der aktualisierten Prozessobjekte bereitstellt, die nach Prozess-ID indexiert sind. Entspricht onUpdate, wobei jedem Process-Objekt Details zur Arbeitsspeichernutzung hinzugefügt wurden. Hinweis: Das Erfassen von Informationen zur Arbeitsspeichernutzung verursacht eine zusätzliche CPU-Auslastung und sollte nur bei Bedarf überwacht werden.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processes: object)=>void

    • Verfahren

      Objekt