Process |
Processus |
|---|---|
| Node.js | |
Description
Ce module est un objet global fournissant des informations à propos du processus courant «Node.js» et de ses contrôles.
Liste des méthodes
| Nom | Description |
|---|---|
| abort | Cette méthode permet d'entraîner la fermeture immédiate du processus Node.js et la génération d'un fichier core. |
| allowedNodeEnvironmentFlags | Cette méthode contient un ensemble spécial, en lecture seulement, d'indicateurs autorisés dans la variable d'environnement NODE_OPTIONS. |
| arch | Cette méthode permet d'indiquer l'architecture du processeur du système d'exploitation pour laquelle le binaire Node.js a été compilé. Les valeurs possibles sont : 'arm', 'arm64', 'ia32', 'mips','mipsel', 'ppc', 'ppc64', 's390', 's390x', 'x32' et 'x64'. |
| argv | Cette méthode permet de retourner un tableau contenant les paramètres de ligne de commande transmis lors du lancement du processus Node.js. |
| argv0 | Cette méthode permet d'entreposer une copie en lecture seulement de la valeur d'origine de argv[0] transmise au démarrage de Node.js. |
| channel | Cette méthode permet d'indiquer une référence au canal IPC. Si aucun canal IPC n'existe, elle n'est pas définie. |
| channel.ref | Cette méthode permet au canal IPC de garder la boucle d'événements du processus en cours d'exécution si .unref() a été appelée auparavant. |
| channel.unref | Cette méthode permet d'empêcher le canal IPC de maintenir la boucle d'événements du processus en cours d'exécution et lui permet de se terminer même lorsque le canal est ouvert. |
| chdir | Cette méthode permet de modifier le répertoire de travail actuel du processus Node.js ou lève une exception en cas d'échec (par exemple, si le répertoire spécifié n'existe pas). |
| config | Cette méthode permet de retourner un Object contenant la représentation JavaScript des options de configuration utilisées pour compiler l'exécutable Node.js actuel. C'est le même que le fichier config.gypi ayant été produit lors de l'exécution du script ./configure. |
| connected | Cette méthode permet d'indiquer si le processus Node.js est généré avec un canal IPC, la propriété process.connected retournera true tant que le canal IPC est connecté et retournera false après l'appel de process.disconnect(). |
| cpuUsage | Cette méthode permet l'utilisation du temps du microprocesseur par l'utilisateur et le système du processus en cours, dans un objet avec les propriétés utilisateur et système, dont les valeurs sont des valeurs en microsecondes (millionième de seconde). Ces valeurs mesurent respectivement le temps passé dans le code utilisateur et le code système et peuvent finir par être supérieures au temps écoulé réel si plusieurs coeurs de processeur exécutent des travaux pour ce processus. |
| cwd | Cette méthode permet de retourner le répertoire de travail actuel du processus Node.js. |
| debugPort | Cette méthode permet d'indiquer le port utilisé par le débogueur Node.js lorsqu'il est activé. |
| disconnect | Cette méthode permet de fermer le canal IPC vers le processus parent, permettant au processus enfant de quitter correctement une fois qu'il n'y a pas d'autres connexions le gardant en vie si le processus Node.js est généré avec un canal IPC. |
| dlopen | Cette méthode permet de charger dynamiquement des objets partagés. Il est principalement utilisé par require() pour charger des C++ Addons, et ne doit pas être utilisé directement, sauf dans des cas particuliers. En d'autres termes, require() devrait être préféré à process.dlopen() à moins qu'il n'y ait des raisons spécifiques telles que des drapeaux dlopen personnalisés ou le chargement depuis des modules ES. |
| emitWarning | Cette méthode permet d'émettre des avertissements de processus personnalisés ou spécifiques à une application. Ceux-ci peuvent être écoutés en ajoutant un gestionnaire à l'événement 'warning'. |
| env | Cette méthode permet de retourner un objet contenant l'environnement utilisateur. |
| execArgv | Cette méthode permet de retourner l'ensemble des options de ligne de commande spécifiques à Node.js transmises lors du lancement du processus Node.js. |
| execPath | Cette méthode permet de retourner le chemin absolu de l'exécutable qui a démarré le processus Node.js. Les liens symboliques, le cas échéant, sont résolus. |
| exit | Cette méthode permet de demander à Node.js de terminer le processus de manière synchronisé avec un état de sortie de code. Si le code est omis, exit utilise soit le code 0 pour 'success', soit la valeur de process.exitCode s'il a été défini. Le Node.js ne se terminera pas tant que tous les écouteurs d'événement 'exit' n'auront pas été appelés. |
| exitCode | Cette méthode permet d'indiquer un nombre étant le code de sortie du processus, lorsque le processus se termine correctement ou est quitté via process.exit() sans spécifier de code. |
| getegid | Cette méthode permet de retourner l'identité numérique du groupe effectif du processus Node.js. |
| geteuid | Cette méthode permet de retourner l'identité numérique effective de l'utilisateur du processus. |
| getgid | Cette méthode permet de retourner l'identité de groupe numérique du processus. |
| getgroups | Cette méthode permet de retourner un tableau avec les identificateurs de groupe supplémentaires. Le POSIX ne spécifie pas si l'identificateur de groupe effectif est inclus, mais Node.js garantit qu'il l'est toujours. |
| getuid | Cette méthode permet de retourner l'identité numérique de l'utilisateur du processus. |
| hasUncaughtExceptionCaptureCallback | Cette méthode permet d'indiquer si un rappel a été défini à l'aide de process.setUncaughtExceptionCaptureCallback(). |
| hrtime | Cette méthode permet de retourner le temps réel haute résolution actuel dans un tuple Array [seconds, nanoseconds], où nanoseconds est la partie restante du temps réel ne pouvant pas être représentée en seconde précision. |
| hrtime.bigint | Cette méthode permet de retourner le temps réel haute résolution actuel en nanosecondes sous forme de bigint. |
| initgroups | Cette méthode permet de lire le fichier /etc/group et d'initialiser la liste d'accès aux groupes, en utilisant tous les groupes dont l'utilisateur est membre. Il s'agit d'une opération privilégiée nécessitant que le processus Node.js dispose d'un accès root ou de la capacité CAP_SETGID. |
| kill | Cette méthode permet de retourner le signal au processus identifié par pid. |
| mainModule | Cette méthode permet de fournir une autre manière de récupérer require.main. La différence est que si le module principal change au moment de l'exécution, require.main peut toujours faire référence au module principal d'origine dans les modules étant requis avant la modification. En règle générale, il est prudent de supposer que les deux font référence au même module. |
| memoryUsage | Cette méthode permet de retourner un objet décrivant l'utilisation de la mémoire du processus Node.js mesurée en octets. |
| memoryUsage.rss | Cette méthode permet de retourner un entier représentant la taille de l'ensemble résident RSS (Resident Set Size) en octets. |
| nextTick | Cette méthode permet d'ajouter un rappel à la «file d'attente de tics suivante». Cette file d'attente est entièrement vidée une fois l'opération en cours sur la pile JavaScript terminée et avant que la boucle d'événements ne soit autorisée à se poursuivre. Il est possible de créer une boucle infinie si l'on appelle récursivement process.nextTick(). |
| noDeprecation | Cette méthode permet d'indiquer si le drapeau --no-deprecation est défini sur le processus Node.js actuel. |
| pid | Cette méthode permet de retourner le PID du processus. |
| platform | Cette méthode permet de retourner une chaîne de caractères identifiant la plate-forme du système d'exploitation sur laquelle le processus Node.js s'exécute. |
| ppid | Cette méthode permet de retourner le PID du parent du processus en cours. |
| release | Cette méthode permet de retourner un objet contenant des métadonnées liées à la version actuelle, y compris des URL pour l'archive tar source et l'archive tar avec entêtes uniquement. |
| report | Cette méthode permet de générer des rapports de diagnostic pour le processus en cours. |
| report.compact | Cette méthode permet de rédiger des rapports dans un format compact, JSON sur une seule ligne, plus facilement consommable par les systèmes de traitement des journaux que le format multiligne par défaut conçu pour la consommation humaine. |
| report.directory | Cette méthode permet d'indiquer le répertoire dans lequel le rapport est rédigé. La valeur par défaut est la chaîne de caractères vide, indiquant que les rapports sont écrits dans le répertoire de travail actuel du processus Node.js. |
| report.filename | Cette méthode permet d'indiquer le nom de fichier dans lequel le rapport est écrit. S'il est défini sur la chaîne de caractères vide, le nom du fichier de sortie sera composé d'un horodatage, d'un PID et d'un numéro de séquence. La valeur par défaut est la chaîne de caractères vide. |
| report.getReport | Cette méthode permet de retourner une représentation d'objet JavaScript d'un rapport de diagnostic pour le processus en cours d'exécution. La trace de la pile JavaScript du rapport est extraite de err, si elle est présente. |
| report.reportOnFatalError | Cette méthode permet d'indiquer, si la valeur est true, qu'un rapport de diagnostic est généré sur les erreurs fatales, telles que les erreurs de mémoire insuffisante ou les assertions C++ ayant échoué. |
| report.reportOnSignal | Cette méthode permet d'indiquer, si la valeur est true, qu'un rapport de diagnostic est généré lorsque le processus reçoit le signal spécifié par process.report.signal. |
| report.reportOnUncaughtException | Cette méthode permet d'indiquer, si la valeur est true, qu'un rapport de diagnostic est généré en cas d'exception non interceptée. |
| report.signal | Cette méthode permet d'indiquer le signal utilisé pour déclencher la création d'un rapport de diagnostic. La valeur par défaut est «SIGUSR2». |
| report.writeReport | Cette méthode permet d'écrire un rapport de diagnostic dans un fichier. Si le nom de fichier n'est pas fourni, le nom de fichier par défaut comprend la date, l'heure, le PID et un numéro de séquence. La trace de la pile JavaScript du rapport est extraite de err, si elle est présente. |
| resourceUsage | Cette méthode permet de retourner l'utilisation des ressources pour le processus en cours. |
| send | Cette méthode permet d'envoyer un message. |
| setegid | Cette méthode permet de définir l'identité de groupe effective du processus. |
| seteuid | Cette méthode permet de définir l'identité d'utilisateur effective du processus. |
| setgid | Cette méthode permet de définir l'identité de groupe du processus. |
| setgroups | Cette méthode permet de définir les identificateurs de groupe supplémentaires pour le processus Node.js. Il s'agit d'une opération privilégiée nécessitant que le processus Node.js ait la racine ou la capacité CAP_SETGID. |
| setuid | Cette méthode permet de définir l'identité de l'utilisateur du processus. |
| setUncaughtExceptionCaptureCallback | Cette méthode permet de définir une fonction étant appelée lorsqu'une exception non interceptée se produit, recevant la valeur d'exception elle-même comme premier paramètre. |
| stderr | Cette méthode permet de retourner un flux connecté à stderr. Il s'agit d'un net.Socket (étant un flux Duplex) sauf si fd fait référence à un fichier, auquel cas il s'agit d'un flux inscriptible. |
| stderr.fd | Cette méthode permet de faire référence à la valeur du descripteur de fichier sous-jacent de process.stderr. La valeur est fixée à 2. Dans les processus léger Worker, ce champ n'existe pas. |
| stdin | Cette méthode permet de retourner un flux connecté à stdin. |
| stdin.fd | Cette méthode permet de faire référence à la valeur du descripteur de fichier sous-jacent de process.stdin. La valeur est fixée à 0. Dans les processus léger Worker, ce champ n'existe pas. |
| stdout | Cette méthode permet de retourner un flux connecté à stdout. |
| stdout.fd | Cette méthode permet de faire référence à la valeur du descripteur de fichier sous-jacent de process.stdout. La valeur est fixée à 1. Dans les processus léger Worker, ce champ n'existe pas. |
| throwDeprecation | Cette méthode permet d'indiquer si le drapeau --throw-deprecation est défini sur le processus Node.js actuel. |
| title | Cette méthode permet de retourner le titre du processus actuel (c'est-à-dire renvoie la valeur actuelle de ps). L'attribution d'une nouvelle valeur à process.title modifie la valeur actuelle de ps. |
| traceDeprecation | Cette méthode permet d'indiquer si le drapeau --trace-deprecation est défini sur le processus Node.js actuel. |
| umask | Cette méthode permet de retourner le masque de création du mode fichier du processus Node.js. Les processus enfants héritent du masque du processus parent. |
| uptime | Cette méthode permet de retourner le nombre de secondes que le processus Node.js actuel a exécuté. |
| version | Cette méthode permet d'indiquer la chaîne de caractères de version Node.js. |
| versions | Cette méthode permet de retourner un objet répertoriant les chaînes de caractères de version de Node.js et de ses dépendances. |
Dernière mise à jour : Vendredi, le 5 Mars 2021