ProcessError class

Pacote:
@azure/core-process

Um erro surgido durante a resolução ou execução de um processo.

A saída capturada é não enumerável, pelo que o registo e a serialização ordinários não a expõem acidentalmente.

Extends

Error

Construtores

ProcessError(string, ProcessErrorOptions)

Cria um erro de processo.

Propriedades

code

O código de erro do sistema operativo ou o código de saída do processo.
killed

Se o processo foi eliminado.
signal

O sinal que terminou o processo.
stderr

Erro padrão capturado, quando disponível.
stdout

Captura de saída padrão, quando disponível.

Propriedades Herdadas

message
name
stack
stackTraceLimit

A Error.stackTraceLimit propriedade especifica o número de frames de pilha recolhidos por um traço de pilha (seja gerado por new Error().stack ou Error.captureStackTrace(obj)).

O valor predefinido é 10 , mas pode ser definido para qualquer número JavaScript válido. As alterações afetarão qualquer rastreio de pilha capturado após a alteração do valor.

Se definidos para um valor que não seja numérico, ou para um número negativo, os trilhos de pilha não capturam quaisquer frames.

Métodos Herdados

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, quando acedida, devolve uma string que representa a localização no código onde Error.captureStackTrace() foi chamada.

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

A primeira linha do traço será precedida por ${myObject.name}: ${myObject.message}.

O argumento opcional constructorOpt aceita uma função. Se forem dados, todos os frames acima constructorOptde , incluindo constructorOpt, serão omitidos do traço de pilha gerado.

O constructorOpt argumento é útil para ocultar detalhes da implementação da geração de erros ao utilizador. Por exemplo:

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

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

Detalhes do Construtor

ProcessError(string, ProcessErrorOptions)

Cria um erro de processo.

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

Parâmetros

message

string

Uma mensagem que não contém argumentos de comando ou saída.

options
ProcessErrorOptions

Detalhes estruturados de falhas de processos.

Detalhes de Propriedade

code

O código de erro do sistema operativo ou o código de saída do processo.

code: null | string | number

Valor de Propriedade

null | string | number

killed

Se o processo foi eliminado.

killed: boolean

Valor de Propriedade

boolean

signal

O sinal que terminou o processo.

signal: null | Signals

Valor de Propriedade

null | Signals

stderr

Erro padrão capturado, quando disponível.

stderr: undefined | string | Buffer

Valor de Propriedade

undefined | string | Buffer

stdout

Captura de saída padrão, quando disponível.

stdout: undefined | string | Buffer

Valor de Propriedade

undefined | string | Buffer

Detalhes da Propriedade Herdada

message 

message: string

Valor de Propriedade

string

herdado de Error.message

name 

name: string

Valor de Propriedade

string

herdada de Error.name

stack 

stack?: string

Valor de Propriedade

string

herdado de Error.stack

stackTraceLimit

A Error.stackTraceLimit propriedade especifica o número de frames de pilha recolhidos por um traço de pilha (seja gerado por new Error().stack ou Error.captureStackTrace(obj)).

O valor predefinido é 10 , mas pode ser definido para qualquer número JavaScript válido. As alterações afetarão qualquer rastreio de pilha capturado após a alteração do valor.

Se definidos para um valor que não seja numérico, ou para um número negativo, os trilhos de pilha não capturam quaisquer frames.

static stackTraceLimit: number

Valor de Propriedade

number

Herdado de Error.stackTraceLimit

Detalhes do Método Herdado

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, quando acedida, devolve uma string que representa a localização no código onde Error.captureStackTrace() foi chamada.

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

A primeira linha do traço será precedida por ${myObject.name}: ${myObject.message}.

O argumento opcional constructorOpt aceita uma função. Se forem dados, todos os frames acima constructorOptde , incluindo constructorOpt, serão omitidos do traço de pilha gerado.

O constructorOpt argumento é útil para ocultar detalhes da implementação da geração de erros ao utilizador. Por exemplo:

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)

Parâmetros

targetObject

object

constructorOpt

Function

Herdado de Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parâmetros

err

Error

stackTraces

CallSite[]

Devoluções

any

Herdado de Error.prepareStackTrace