chrome.processes

Description

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

Autorisations

processes

Disponibilité

<ph type="x-smartling-placeholder"></ph> Version en 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

    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. Cela donne une valeur de zéro à 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 d'onUpdated ou de 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 d'onUpdated ou de onUpdatedWithMemory.

  • id

    Nombre

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

  • jsMemoryAllocated

    numéro facultatif

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

  • jsMemoryUsed

    numéro facultatif

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

  • naclDebugPort

    Nombre

    Port de débogage pour les processus Native Client. Zéro pour les autres types de processus et 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 par le processus, en octets par seconde. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel d'onUpdated ou de onUpdatedWithMemory.

  • osProcessId

    Nombre

    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 du processus, en octets. Disponible uniquement lors de la réception de l'objet dans le cadre d'un rappel d'onUpdatedWithMemory ou de 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 d'onUpdated ou de onUpdatedWithMemory.

  • sqliteMemory

    numéro facultatif

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

"navigateur"

&quot;renderer&quot;

"extension"

"notification"

"plug-in"

"worker"

"nacl"

"service_worker"

"services publics"

"gpu"

"autre"

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 dans un processus de moteur de rendu.

  • titre

    chaîne

    Titre de la tâche.

Méthodes

getProcessIdForTab()

<ph type="x-smartling-placeholder"></ph> 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

    Nombre

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

  • rappel

    function facultatif

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

    (processId: number) => void

    • processId

      Nombre

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

Renvoie

  • Promise&lt;number&gt;

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

getProcessInfo()

<ph type="x-smartling-placeholder"></ph> 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

    numéro | numéro[]

    Liste des identifiants de processus ou identifiant de processus unique pour lesquels renvoyer les informations de 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 interrogé que lorsque cela est nécessaire.

  • rappel

    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 en direct du processus de navigateur actuel, indexé par ID de processus. Les métriques nécessitant une agrégation au fil du temps ne sont pas renseignées dans chaque objet Process.

Renvoie

  • Promise&lt;object&gt;

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

terminate()

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

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

Paramètres

  • processId

    Nombre

    Identifiant du processus à mettre fin.

  • rappel

    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 et "false" dans le cas contraire.

Renvoie

  • Promise&lt;boolean&gt;

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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éé, fournissant l'objet Processus correspondant.

Paramètres

  • rappel

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

Paramètres

  • rappel

    fonction

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

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

    • processId

      Nombre

    • exitType

      Nombre

    • codesortie

      Nombre

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

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

Paramètres

  • rappel

    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 ses statistiques de processus, fournissant le dictionnaire des objets Process mis à jour, indexés par identifiant de processus. Identique à onUpdate, avec en plus des détails d'utilisation de la 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 qu'en cas de besoin.

Paramètres

  • rappel

    fonction

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

    (processes: object) => void

    • processes

      objet