ProcessError class

Pacchetto:
@azure/core-process

Un errore viene generato durante la risoluzione o l'esecuzione di un processo.

L'output catturato è non enumerabile, quindi il log ordinario e la serializzazione non lo espongono accidentalmente.

Extends

Error

Costruttori

ProcessError(string, ProcessErrorOptions)

Crea un errore di processo.

Proprietà

code

Il codice di errore del sistema operativo o il codice di uscita del processo.
killed

Se il processo è stato interrotto.
signal

Il segnale che ha interrotto il processo.
stderr

Errore standard catturato, quando disponibile.
stdout

Registra l'output standard, quando disponibile.

Proprietà ereditate

message
name
stack
stackTraceLimit

La Error.stackTraceLimit proprietà specifica il numero di frame di stack raccolti da una traccia di stack (che sia generata da new Error().stack o Error.captureStackTrace(obj)).

Il valore predefinito è 10 ma può essere impostato a qualsiasi numero JavaScript valido. Le modifiche influenzeranno qualsiasi traccia dello stack catturata dopo che il valore è stato modificato.

Se impostato a un valore non numerico, o a un numero negativo, le traccia dello stack non cattureranno alcun fotogramma.

Metodi ereditati

captureStackTrace(object, Function)

Crea una .stack proprietà su targetObject, che quando accedita restituisce una stringa che rappresenta la posizione nel codice a cui Error.captureStackTrace() è stato chiamato.

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

La prima riga della traccia sarà preceduta da ${myObject.name}: ${myObject.message}.

L'argomento opzionale constructorOpt accetta una funzione. Se dato, tutti i frame sopra constructorOpt, incluso constructorOpt, verranno omessi dalla traccia dello stack generata.

L'argomento constructorOpt è utile per nascondere i dettagli dell'implementazione della generazione degli errori all'utente. Per esempio:

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[])

Fare riferimento a https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Dettagli costruttore

ProcessError(string, ProcessErrorOptions)

Crea un errore di processo.

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

Parametri

message

string

Un messaggio che non contiene argomenti di comando o output.

options
ProcessErrorOptions

Dettagli strutturati sul fallimento del processo.

Dettagli proprietà

code

Il codice di errore del sistema operativo o il codice di uscita del processo.

code: null | string | number

Valore della proprietà

null | string | number

killed

Se il processo è stato interrotto.

killed: boolean

Valore della proprietà

boolean

signal

Il segnale che ha interrotto il processo.

signal: null | Signals

Valore della proprietà

null | Signals

stderr

Errore standard catturato, quando disponibile.

stderr: undefined | string | Buffer

Valore della proprietà

undefined | string | Buffer

stdout

Registra l'output standard, quando disponibile.

stdout: undefined | string | Buffer

Valore della proprietà

undefined | string | Buffer

Dettagli proprietà ereditate

message 

message: string

Valore della proprietà

string

Ereditato da Error.message

name 

name: string

Valore della proprietà

string

ereditato da Error.name

stack 

stack?: string

Valore della proprietà

string

ereditato da Error.stack

stackTraceLimit

La Error.stackTraceLimit proprietà specifica il numero di frame di stack raccolti da una traccia di stack (che sia generata da new Error().stack o Error.captureStackTrace(obj)).

Il valore predefinito è 10 ma può essere impostato a qualsiasi numero JavaScript valido. Le modifiche influenzeranno qualsiasi traccia dello stack catturata dopo che il valore è stato modificato.

Se impostato a un valore non numerico, o a un numero negativo, le traccia dello stack non cattureranno alcun fotogramma.

static stackTraceLimit: number

Valore della proprietà

number

Ereditato da Error.stackTraceLimit

Dettagli dei metodi ereditati

captureStackTrace(object, Function)

Crea una .stack proprietà su targetObject, che quando accedita restituisce una stringa che rappresenta la posizione nel codice a cui Error.captureStackTrace() è stato chiamato.

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

La prima riga della traccia sarà preceduta da ${myObject.name}: ${myObject.message}.

L'argomento opzionale constructorOpt accetta una funzione. Se dato, tutti i frame sopra constructorOpt, incluso constructorOpt, verranno omessi dalla traccia dello stack generata.

L'argomento constructorOpt è utile per nascondere i dettagli dell'implementazione della generazione degli errori all'utente. Per esempio:

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)

Parametri

targetObject

object

constructorOpt

Function

Ereditato da Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

Fare riferimento a https://v8.dev/docs/stack-trace-api#customizing-stack-traces

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

Parametri

err

Error

stackTraces

CallSite[]

Valori restituiti

any

Ereditato da Error.prepareStackTrace