chrome.processes

Description

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

Autorisations

processes

Garantie de disponibilité

Version en développement

Types

Cache

Propriétés

  • liveSize

    number

    Partie du cache utilisée, en octets.

  • taille

    number

    Taille du cache, en octets.

Process

Propriétés

  • cpu

    numéro 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. Ce code donne une valeur comprise entre zéro à CpuInfo.numOfProcessors*100, ce 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 de onUpdated ou onUpdatedWithMemory.

  • cssCache

    Cache facultatif

    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 de onUpdated ou onUpdatedWithMemory.

  • id

    number

    ID unique du processus fourni par le navigateur.

  • imageCache

    Cache facultatif

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

  • jsMemoryAllocated

    numéro facultatif

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

  • jsMemoryUsed

    numéro facultatif

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

  • naclDebugPort

    number

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

  • réseau

    numéro facultatif

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

  • osProcessId

    number

    ID du processus, tel que fourni par le système d'exploitation.

  • privateMemory

    numéro facultatif

    Mesure la plus récente de l'utilisation de la mémoire privée des processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel 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 du script pour le processus. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel de onUpdated ou onUpdatedWithMemory.

  • sqliteMemory

    numéro facultatif

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

  • tasks

    TaskInfo[]

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

  • Type de processus.

ProcessType

Types de processus effectués par le navigateur.

Enum

"browser" (navigateur)

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"

"utility"

"gpu"

TaskInfo

Propriétés

  • tabId

    numéro facultatif

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

  • title

    chaîne

    Titre de la tâche.

Méthodes

getProcessIdForTab()

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

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

Paramètres

  • tabId

    number

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

  • rappel

    fonction facultative

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

    (processId: number)=>void

    • processId

      number

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

Renvoie

  • Promesse<number>

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue 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 de processus pour chaque identifiant de processus spécifié.

Paramètres

  • processIds

    nombre|nombre[]

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

  • includeMemory

    boolean

    "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 interrogée que si nécessaire.

  • rappel

    fonction facultative

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

    (processes: object)=>void

    • processes

      objet

      Un dictionnaire d'objets Process pour chaque processus demandé. Il s'agit d'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 Processus.

Renvoie

  • Promise<object>

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

terminate()

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

Arrête le processus du moteur de rendu spécifié. Cela équivaut à visiter about:crash, mais sans modifier l'URL de l'onglet.

Paramètres

  • processId

    number

    ID du processus à arrêter.

  • rappel

    fonction facultative

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

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

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

Renvoie

  • Promise<boolean>

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue 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éé et fourni l'objet Process correspondant.

Paramètres

  • rappel

    function

    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 se termine, ce qui indique le type de sortie.

Paramètres

  • rappel

    function

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

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

    • processId

      number

    • exitType

      number

    • exitCode

      number

onUnresponsive

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

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

Paramètres

  • rappel

    function

    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 de tâches met à jour ses statistiques de processus, en fournissant le dictionnaire des objets Process mis à jour, indexés par identifiant de processus.

Paramètres

  • rappel

    function

    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 de tâches met à jour ses statistiques de processus, en fournissant le dictionnaire des objets Process mis à jour, indexés par identifiant de processus. Identique à onUpdate, avec l'ajout des détails d'utilisation de mémoire inclus 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 que lorsque cela est nécessaire.

Paramètres

  • rappel

    function

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

    (processes: object)=>void

    • processes

      objet