ProcessError class

Paquet:
@azure/core-process

Une erreur générée lors de la résolution ou de l’exécution d’un processus.

La sortie capturée est non énumérable, donc la journalisation ordinaire et la sérialisation ne l’exposent pas accidentellement.

Extends

Error

Constructeurs

ProcessError(string, ProcessErrorOptions)

Crée une erreur de processus.

Propriétés

code

Le code d’erreur du système d’exploitation ou le code de sortie du processus.
killed

Si le processus a été tué.
signal

Le signal qui a mis fin au processus.
stderr

Erreur standard capturée, quand disponible.
stdout

Capture de sortie standard, lorsque disponible.

Propriétés héritées

message
name
stack
stackTraceLimit

La Error.stackTraceLimit propriété spécifie le nombre de trames de pile collectées par une trace de pile (qu’elle soit générée par new Error().stack ou Error.captureStackTrace(obj)).

La valeur par défaut est 10 , mais peut être définie à n’importe quel numéro JavaScript valide. Les modifications affecteront toute trace de pile capturée après que la valeur ait été modifiée.

Si elles sont fixées à une valeur non numérique, ou à un nombre négatif, les traces de pile ne captureront aucune trame.

Méthodes héritées

captureStackTrace(object, Function)

Crée une .stack propriété sur targetObject, qui, lorsqu’elle est consultée, renvoie une chaîne représentant l’emplacement dans le code où Error.captureStackTrace() il a été appelé.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`

La première ligne de la trace sera précédée de ${myObject.name}: ${myObject.message}.

L’argument optionnel constructorOpt accepte une fonction. Si elle est donnée, toutes les trames au-dessus constructorOptde , y compris constructorOpt, seront omises de la trace de pile générée.

Cet constructorOpt argument est utile pour cacher aux utilisateurs les détails de la génération d’erreurs sur l’implémentation. Exemple :

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();
prepareStackTrace(Error, CallSite[])

Voir https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Détails du constructeur

ProcessError(string, ProcessErrorOptions)

Crée une erreur de processus.

new ProcessError(message: string, options?: ProcessErrorOptions)

Paramètres

message

string

Un message qui ne contient ni arguments de commande ni sortie.

options
ProcessErrorOptions

Détails structurés de défaillance des processus.

Détails de la propriété

code

Le code d’erreur du système d’exploitation ou le code de sortie du processus.

code: null | string | number

Valeur de propriété

null | string | number

killed

Si le processus a été tué.

killed: boolean

Valeur de propriété

boolean

signal

Le signal qui a mis fin au processus.

signal: null | Signals

Valeur de propriété

null | Signals

stderr

Erreur standard capturée, quand disponible.

stderr: undefined | string | Buffer

Valeur de propriété

undefined | string | Buffer

stdout

Capture de sortie standard, lorsque disponible.

stdout: undefined | string | Buffer

Valeur de propriété

undefined | string | Buffer

Détails de la propriété héritée

message 

message: string

Valeur de propriété

string

héritée de Error.message

name 

name: string

Valeur de propriété

string

héritée de Error.name

stack 

stack?: string

Valeur de propriété

string

héritée de Error.stack

stackTraceLimit

La Error.stackTraceLimit propriété spécifie le nombre de trames de pile collectées par une trace de pile (qu’elle soit générée par new Error().stack ou Error.captureStackTrace(obj)).

La valeur par défaut est 10 , mais peut être définie à n’importe quel numéro JavaScript valide. Les modifications affecteront toute trace de pile capturée après que la valeur ait été modifiée.

Si elles sont fixées à une valeur non numérique, ou à un nombre négatif, les traces de pile ne captureront aucune trame.

static stackTraceLimit: number

Valeur de propriété

number

Hérité de Error.stackTraceLimit

Détails de la méthode héritée

captureStackTrace(object, Function)

Crée une .stack propriété sur targetObject, qui, lorsqu’elle est consultée, renvoie une chaîne représentant l’emplacement dans le code où Error.captureStackTrace() il a été appelé.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`

La première ligne de la trace sera précédée de ${myObject.name}: ${myObject.message}.

L’argument optionnel constructorOpt accepte une fonction. Si elle est donnée, toutes les trames au-dessus constructorOptde , y compris constructorOpt, seront omises de la trace de pile générée.

Cet constructorOpt argument est utile pour cacher aux utilisateurs les détails de la génération d’erreurs sur l’implémentation. Exemple :

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();

static function captureStackTrace(targetObject: object, constructorOpt?: Function)

Paramètres

targetObject

object

constructorOpt

Function

Hérité de Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

Voir https://v8.dev/docs/stack-trace-api#customizing-stack-traces

static function prepareStackTrace(err: Error, stackTraces: CallSite[]): any

Paramètres

err

Error

stackTraces

CallSite[]

Retours

any

Hérité de Error.prepareStackTrace