chrome.processes

Description

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

Autorisations

processes

Disponibilité

Chaîne de développement

Types

Cache

Propriétés

  • liveSize

    Total

    Partie du cache utilisée, en octets.

  • taille

    Total

    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 lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • cssCache

    Cache facultatif

    Informations les plus récentes sur le cache CSS du processus. Disponible uniquement lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • id

    Total

    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 lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • jsMemoryAllocated

    number facultatif

    Mesure la plus récente de la mémoire allouée par le processus JavaScript, en octets. Disponible uniquement lorsque vous recevez l'objet dans le cadre d'un rappel 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 lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • naclDebugPort

    Total

    Port de débogage pour les processus Native Client. "0" pour les autres types de processus et pour les processus NaCl pour lesquels 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 lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • osProcessId

    Total

    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 lorsque vous recevez l'objet dans le cadre d'un rappel à partir de 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 du processus. Disponible uniquement lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • sqliteMemory

    number facultatif

    Mesure la plus récente de l'utilisation de la mémoire SQLite par le processus, en octets. Disponible uniquement lorsque vous recevez l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • tâches

    TaskInfo[]

    Tableau de TaskInfos représentant les tâches exécutées sur ce processus.

  • Type de processus.

ProcessType

Types de processus du navigateur.

Énumération

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

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

  • titre

    chaîne

    Titre de la tâche.

Méthodes

getProcessIdForTab()

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

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

Paramètres

  • tabId

    Total

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

  • callback

    fonction facultatif

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

    (processId: number) => void

    • processId

      Total

      ID de processus du processeur de rendu de l'onglet.

Renvoie

  • Promise<number>

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

getProcessInfo()

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

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

Paramètres

  • processIds

    nombre | nombre[]

    Liste des ID de processus ou ID de processus unique pour lequel 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 que si nécessaire.

  • callback

    fonction 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 l'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>

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

terminate()

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

Met fin au processus de rendu spécifié. Équivaut à accéder à "about:crash", mais sans modifier l'URL de l'onglet.

Paramètres

  • processId

    Total

    ID du processus à arrêter.

  • callback

    fonction 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, sinon "false".

Renvoie

  • Promise<boolean>

    Les promesses sont compatibles avec la version 3 du fichier manifeste et les versions ultérieures, mais des rappels sont fournis pour la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse se résout avec le même type que celui transmis au rappel.

É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

      Total

    • exitType

      Total

    • exitCode

      Total

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

Appelé chaque fois que le Gestionnaire des tâches met à jour ses statistiques de processus, il fournit le dictionnaire des objets Process mis à jour, indexés par l'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,
)

Appelé chaque fois que le Gestionnaire des tâches met à jour ses statistiques de processus, il fournit le dictionnaire des objets Process mis à jour, indexés par l'ID de processus. Identique à "onUpdate", avec 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 effectuée que si nécessaire.

Paramètres

  • callback

    fonction

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

    (processes: object) => void

    • processes

      objet