chrome.processes

Beschreibung

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

Berechtigungen

processes

Verfügbarkeit

<ph type="x-smartling-placeholder"></ph> Entwicklerversion

Typen

Cache

Attribute

  • liveSize

    Zahl

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

  • Größe

    Zahl

    Die Größe des Cache in Byte.

Process

Attribute

  • cpu

    Zahl 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. Damit wird ein Wert von null bis CpuInfo.numOfProcessors*100 zurückgegeben, 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

    Zahl optional

    Die letzte Messung des vom JavaScript zugeteilten Arbeitsspeichers des Prozesses in Byte. Nur verfügbar, wenn das Objekt als Teil eines Callbacks von onUpdated oder onUpdatedWithMemory empfangen wird.

  • jsMemoryUsed

    Zahl optional

    Die letzte Messung des verwendeten JavaScript-Arbeitsspeichers 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 das Debugging nicht aktiviert ist.

  • Netzwerk

    Zahl 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 vom Betriebssystem bereitgestellte ID des Prozesses.

  • privateMemory

    Zahl 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, mit dem der Prozess verknüpft 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

    Zahl 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.

  • Aufgaben

    TaskInfo[]

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

  • Die Art des Prozesses.

ProcessType

Die Arten der Browserprozesse.

Enum

"Browser"

&quot;renderer&quot;

"Erweiterung"

"Benachrichtigung"

"Plug-in"

"Mitarbeiter"

"nacl"

"service_worker"

"Dienstprogramm"

"gpu"

"Sonstiges"

TaskInfo

Attribute

  • tabId

    Zahl 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()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

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

Parameter

  • tabId

    Zahl

    Die ID des Tabs, für den die Renderer-Prozess-ID 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.

Gibt Folgendes zurück:

  • Promise&lt;number&gt;

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getProcessInfo()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
)

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

Parameter

  • 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 eine detaillierte Arbeitsspeichernutzung erforderlich ist. Hinweis: Das Erfassen von Informationen zur Arbeitsspeichernutzung führt zu einer zusätzlichen CPU-Nutzung 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 aktiven untergeordneten Prozess des aktuellen Browserprozesses handelt, indexiert nach Prozess-ID. Messwerte, die im Laufe der Zeit aggregiert werden müssen, werden nicht in die einzelnen Prozessobjekte eingefügt.

Gibt Folgendes zurück:

  • Promise&lt;object&gt;

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

terminate()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

Beendet den angegebenen Renderer-Prozess. Entspricht dem Aufrufen von about:crash, aber ohne Änderung der URL des Tabs.

Parameter

  • processId

    Zahl

    Die ID des Prozesses, der beendet werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (didTerminate: boolean) => void

    • didTerminate

      boolean

      Der Wert ist "True", wenn der Prozess erfolgreich beendet wurde, andernfalls "False".

Gibt Folgendes zurück:

  • Promise&lt;boolean&gt;

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

Ereignisse

onCreated

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

Wird bei jeder Erstellung eines Prozesses ausgelöst, wobei das zugehörige Prozessobjekt angegeben wird

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (process: Process) => void

onExited

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

Wird bei jedem Beenden eines Prozesses ausgelöst, wobei der Exit-Typ angegeben wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • processId

      Zahl

    • exitType

      Zahl

    • Exit-Code

      Zahl

onUnresponsive

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

Wird jedes Mal ausgelöst, wenn ein Prozess nicht mehr reagiert und das zugehörige Prozessobjekt bereitstellt.

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

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 und das Wörterbuch der aktualisierten Prozessobjekte bereitstellt, indexiert nach Prozess-ID. Identisch mit onUpdate, mit zusätzlichen Details zur Arbeitsspeichernutzung in jedem Process-Objekt. Hinweis: Das Erfassen von Informationen zur Arbeitsspeichernutzung führt zu einer zusätzlichen CPU-Nutzung und sollte nur bei Bedarf überwacht werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processes: object) => void

    • Verfahren

      Objekt