ProcessError class

Pakiet:
@azure/core-process

Błąd pojawiający się podczas rozwiązywania lub wykonywania procesu.

Przechwycony wynik jest niepoliczalny, więc zwykłe logowanie i serializacja nie ujawniają go przypadkowo.

Rozszerzenie

Error

Konstruktory

ProcessError(string, ProcessErrorOptions)

Powoduje błąd procesu.

Właściwości

code

Kod błędu systemu operacyjnego lub kod wyjścia z procesu.
killed

Czy proces został zabity.
signal

Sygnał, który zakończył proces.
stderr

Rejestrowałem błąd standardowy, gdy był dostępny.
stdout

Rejestrowałem standardowe wyjście, gdy było dostępne.

Właściwości dziedziczone

message
name
stack
stackTraceLimit

Właściwość ta Error.stackTraceLimit określa liczbę ramek stosu zebranych przez ślad stosu (niezależnie od tego, czy generowany przez new Error().stack lub Error.captureStackTrace(obj)).

Domyślna wartość to, 10 ale może być ustawiona na dowolny poprawny numer JavaScript. Zmiany wpłyną na wszelkie ślady stosu przechwycone po zmianie wartości.

Jeśli ustawione są na wartość nieliczbową lub ujemną, ślady stosu nie przechwytują żadnych klatek.

Metody dziedziczone

captureStackTrace(object, Function)

Tworzy właściwość .stack na targetObject, która po utworzeniu zwraca ciąg reprezentujący lokalizację w kodzie, w którym Error.captureStackTrace() został wywołany.

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

Pierwsza linia śladu będzie poprzedzona przez .${myObject.name}: ${myObject.message}

Argument opcjonalny constructorOpt akceptuje funkcję. Jeśli podane, wszystkie ramki powyżej constructorOpt, włącznie z constructorOpt, zostaną pominięte z generowanego śladu stosu.

Argument ten constructorOpt jest przydatny do ukrywania szczegółów generowania błędów implementacyjnych przed użytkownikiem. Przykład:

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

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

Szczegóły konstruktora

ProcessError(string, ProcessErrorOptions)

Powoduje błąd procesu.

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

Parametry

message

string

Wiadomość, która nie zawiera argumentów poleceń ani wyjścia.

options
ProcessErrorOptions

Szczegóły dotyczące ustrukturyzowanych awarii procesów.

Szczegóły właściwości

code

Kod błędu systemu operacyjnego lub kod wyjścia z procesu.

code: null | string | number

Wartość właściwości

null | string | number

killed

Czy proces został zabity.

killed: boolean

Wartość właściwości

boolean

signal

Sygnał, który zakończył proces.

signal: null | Signals

Wartość właściwości

null | Signals

stderr

Rejestrowałem błąd standardowy, gdy był dostępny.

stderr: undefined | string | Buffer

Wartość właściwości

undefined | string | Buffer

stdout

Rejestrowałem standardowe wyjście, gdy było dostępne.

stdout: undefined | string | Buffer

Wartość właściwości

undefined | string | Buffer

Szczegóły właściwości dziedziczonej

message 

message: string

Wartość właściwości

string

dziedziczone z Error.message

name 

name: string

Wartość właściwości

string

dziedziczone z Error.name

stack 

stack?: string

Wartość właściwości

string

dziedziczone z Error.stack

stackTraceLimit

Właściwość ta Error.stackTraceLimit określa liczbę ramek stosu zebranych przez ślad stosu (niezależnie od tego, czy generowany przez new Error().stack lub Error.captureStackTrace(obj)).

Domyślna wartość to, 10 ale może być ustawiona na dowolny poprawny numer JavaScript. Zmiany wpłyną na wszelkie ślady stosu przechwycone po zmianie wartości.

Jeśli ustawione są na wartość nieliczbową lub ujemną, ślady stosu nie przechwytują żadnych klatek.

static stackTraceLimit: number

Wartość właściwości

number

Dziedziczone od Error.stackTraceLimit

Szczegóły metody dziedziczonej

captureStackTrace(object, Function)

Tworzy właściwość .stack na targetObject, która po utworzeniu zwraca ciąg reprezentujący lokalizację w kodzie, w którym Error.captureStackTrace() został wywołany.

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

Pierwsza linia śladu będzie poprzedzona przez .${myObject.name}: ${myObject.message}

Argument opcjonalny constructorOpt akceptuje funkcję. Jeśli podane, wszystkie ramki powyżej constructorOpt, włącznie z constructorOpt, zostaną pominięte z generowanego śladu stosu.

Argument ten constructorOpt jest przydatny do ukrywania szczegółów generowania błędów implementacyjnych przed użytkownikiem. Przykład:

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)

Parametry

targetObject

object

constructorOpt

Function

Dziedziczone od Błąd.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parametry

err

Error

stackTraces

CallSite[]

Zwraca

any

Dziedziczone od Error.prepareStackTrace