chrome.processes

Description

Utilisez l'API chrome.processes pour interagir avec les processus du navigateur.

Autorisations

processes

Disponibilité

Canal de développement

Types

Cache

Propriétés

  • liveSize

    nombre

    Partie du cache utilisée, en octets.

  • taille

    nombre

    Taille du cache, en octets.

Process

Propriétés

  • processeur

    number facultatif

    Mesure la plus récente de l'utilisation du processeur par le processus, exprimée en pourcentage d'un seul cœur de processeur utilisé au total par tous les threads du processus. Cela donne une valeur comprise entre zéro et CpuInfo.numOfProcessors*100, qui peut dépasser 100 % dans les processus multithread. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • cssCache

    Cache facultatif

    Les informations les plus récentes sur le cache CSS pour le processus. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • id

    nombre

    ID unique du processus fourni par le navigateur.

  • imageCache

    Cache facultatif

    Informations les plus récentes sur le cache d'images du processus. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • jsMemoryAllocated

    number facultatif

    Mesure la plus récente de la mémoire JavaScript allouée au processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • jsMemoryUsed

    number facultatif

    Mesure la plus récente de la mémoire JavaScript utilisée par le processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • naclDebugPort

    nombre

    Port de débogage pour les processus Native Client. Zéro pour les autres types de processus et pour les processus NaCl dont le débogage n'est pas activé.

  • réseau

    number facultatif

    Mesure la plus récente de l'utilisation du réseau par le processus, en octets par seconde. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • osProcessId

    nombre

    ID du processus, tel que fourni par l'OS.

  • privateMemory

    number facultatif

    Mesure la plus récente de l'utilisation de la mémoire privée du processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel depuis onUpdatedWithMemory ou getProcessInfo avec l'indicateur includeMemory.

  • profil

    chaîne

    Profil auquel le processus est associé.

  • scriptCache

    Cache facultatif

    Informations les plus récentes sur le cache de script pour le processus. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • sqliteMemory

    number facultatif

    Mesure la plus récente de l'utilisation de la mémoire SQLite du processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel à partir de onUpdated ou onUpdatedWithMemory.

  • tâches

    TaskInfo[]

    Tableau de TaskInfos représentant les tâches en cours d'exécution sur ce processus.

  • Type de processus.

ProcessType

Types de processus du navigateur.

Énumération

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"
Obsolète, ne sera jamais renvoyé.

"nacl"

"service_worker"
Obsolète, ne sera jamais renvoyé.

"utility"

"gpu"

"other"

TaskInfo

Propriétés

  • tabId

    number facultatif

    ID d'onglet facultatif, si cette tâche représente un onglet exécuté sur un processus de rendu.

  • title

    chaîne

    Titre de la tâche.

Méthodes

getProcessIdForTab()

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

Renvoie l'ID du processus de rendu pour l'onglet spécifié.

Paramètres

  • tabId

    nombre

    ID de l'onglet pour lequel l'ID du processus de rendu doit être renvoyé.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (processId: number) => void

    • processId

      nombre

      ID du processus de rendu de l'onglet.

Renvoie

  • Promise<number>

    Rappel permettant de renvoyer l'ID du processus de rendu d'un onglet.

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getProcessInfo()

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

Récupère les informations de processus pour chaque ID de processus spécifié.

Paramètres

  • processIds

    number | number[]

    Liste des ID de processus ou ID de processus unique pour lesquels renvoyer les informations sur le processus. Une liste vide indique que tous les processus sont demandés.

  • includeMemory

    booléen

    "True" si une utilisation détaillée de la mémoire est requise. Notez que la collecte d'informations sur l'utilisation de la mémoire entraîne une utilisation supplémentaire du processeur et ne doit être effectuée qu'en cas de besoin.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (processes: object) => void

    • processes

      objet

      Dictionnaire d'objets Process pour chaque processus demandé qui est un processus enfant actif du processus de navigateur actuel, indexé par ID de processus. Les métriques nécessitant une agrégation au fil du temps ne seront pas renseignées dans chaque objet Process.

Renvoie

  • Promise<object>

    Rappel appelé lorsque les informations sur les processus sont collectées.

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

terminate()

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

Met fin au processus de rendu spécifié. Équivalent à la visite de about:crash, mais sans modifier l'URL de l'onglet.

Paramètres

  • processId

    nombre

    ID du processus à arrêter.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (didTerminate: boolean) => void

    • didTerminate

      booléen

      "True" si l'arrêt du processus a réussi, "false" dans le cas contraire.

Renvoie

  • Promise<boolean>

    Rappel pour signaler l'état de la résiliation.

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onCreated

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

Déclenché chaque fois qu'un processus est créé, en fournissant l'objet Process correspondant.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (process: Process) => void

onExited

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

Déclenché chaque fois qu'un processus est arrêté, en indiquant le type de sortie.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

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

    • processId

      nombre

    • exitType

      nombre

    • exitCode

      nombre

onUnresponsive

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

Déclenché chaque fois qu'un processus ne répond plus, en fournissant l'objet Process correspondant.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (process: Process) => void

onUpdated

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

Déclenché chaque fois que le Gestionnaire des tâches met à jour les statistiques de ses processus, en fournissant le dictionnaire des objets Process mis à jour, indexés par ID de processus.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (processes: object) => void

    • processes

      objet

onUpdatedWithMemory

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

Déclenché chaque fois que le Gestionnaire des tâches met à jour les statistiques de ses processus, en fournissant le dictionnaire des objets Process mis à jour, indexés par ID de processus. Identique à onUpdate, avec en plus des informations sur l'utilisation de la mémoire incluses dans chaque objet Process. Notez que la collecte d'informations sur l'utilisation de la mémoire entraîne une utilisation supplémentaire du processeur et ne doit être écoutée qu'en cas de besoin.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (processes: object) => void

    • processes

      objet