ProcessError class

Pacote:
@azure/core-process

Um erro surgido ao resolver ou executar um processo.

A saída capturada é não enumerável, então o registro e a serialização comuns 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 operacional ou código de saída do processo.
killed

Se o processo foi interrompido.
signal

O sinal que encerrou 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 quadros de pilha coletados por um traço de pilha (seja gerado por new Error().stack ou Error.captureStackTrace(obj)).

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

Se definidos para um valor que não seja número, ou para um número negativo, os traços de pilha não capturarão nenhum quadro.

Métodos herdados

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, ao ser acessada, retorna uma string representando a localização no código em que 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 quadros acima constructorOptde , incluindo constructorOpt, serão omitidos do traço de pilha gerado.

O constructorOpt argumento é útil para esconder detalhes da implementação sobre a geração de erros do usuário. 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[])

Consulte 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 da propriedade

code

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

code: null | string | number

Valor da propriedade

null | string | number

killed

Se o processo foi interrompido.

killed: boolean

Valor da propriedade

boolean

signal

O sinal que encerrou o processo.

signal: null | Signals

Valor da propriedade

null | Signals

stderr

Erro padrão capturado, quando disponível.

stderr: undefined | string | Buffer

Valor da propriedade

undefined | string | Buffer

stdout

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

stdout: undefined | string | Buffer

Valor da propriedade

undefined | string | Buffer

Detalhes das propriedades herdadas

message 

message: string

Valor da propriedade

string

herdado de Error.message

name 

name: string

Valor da propriedade

string

herdado de Error.name

stack 

stack?: string

Valor da propriedade

string

Herdado de Error.stack

stackTraceLimit

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

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

Se definidos para um valor que não seja número, ou para um número negativo, os traços de pilha não capturarão nenhum quadro.

static stackTraceLimit: number

Valor da propriedade

number

Herdado de Error.stackTraceLimit

Detalhes do método herdado

captureStackTrace(object, Function)

Cria uma .stack propriedade em targetObject, que, ao ser acessada, retorna uma string representando a localização no código em que 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 quadros acima constructorOptde , incluindo constructorOpt, serão omitidos do traço de pilha gerado.

O constructorOpt argumento é útil para esconder detalhes da implementação sobre a geração de erros do usuário. 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[])

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

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

Parâmetros

err

Error

stackTraces

CallSite[]

Retornos

any

Herdado de Error.prepareStackTrace