ProcessError class

Paket:
@azure/core-process

Ett fel som uppstår när en process löses eller exekveras.

Den infångade utgången är icke-uppräknbar så vanlig loggning och serialisering exponerar den inte av misstag.

Extends

Error

Konstruktorer

ProcessError(string, ProcessErrorOptions)

Skapar ett processfel.

Egenskaper

code

Operativsystemets felkod eller processavslutningskoden.
killed

Om processen dödades.
signal

Signalen som avslutade processen.
stderr

Fångat standardfel, när det är tillgängligt.
stdout

Fångade standardutdata när det var tillgängligt.

Ärvda egenskaper

message
name
stack
stackTraceLimit

Egenskapen Error.stackTraceLimit specificerar antalet stackramar som samlas in av en stackspårning (oavsett om de genereras av new Error().stack eller Error.captureStackTrace(obj)).

Standardvärdet är 10 men kan sättas till vilket giltigt JavaScript-nummer som helst. Ändringar påverkar alla stackspår som fångas efter att värdet har ändrats.

Om stackspår sätts till ett icke-talvärde, eller till ett negativt tal, kommer stackspår inte att fånga några bildrutor.

Ärvda metoder

captureStackTrace(object, Function)

Skapar en .stack egenskap på targetObject, som när den nås returnerar en sträng som representerar platsen i koden där anropades Error.captureStackTrace() .

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

Den första raden i spåret kommer att prefixeras med ${myObject.name}: ${myObject.message}.

Det valfria constructorOpt argumentet accepterar en funktion. Om det ges kommer alla ramar ovanför constructorOpt, inklusive constructorOpt, att utelämnas från den genererade stackspårningen.

Argumentet constructorOpt är användbart för att dölja implementeringsdetaljer om felgenerering för användaren. Till exempel:

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

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

Konstruktorinformation

ProcessError(string, ProcessErrorOptions)

Skapar ett processfel.

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

Parametrar

message

string

Ett meddelande som inte innehåller kommandoargument eller utdata.

options
ProcessErrorOptions

Strukturerade detaljer om processfel.

Egenskapsinformation

code

Operativsystemets felkod eller processavslutningskoden.

code: null | string | number

Egenskapsvärde

null | string | number

killed

Om processen dödades.

killed: boolean

Egenskapsvärde

boolean

signal

Signalen som avslutade processen.

signal: null | Signals

Egenskapsvärde

null | Signals

stderr

Fångat standardfel, när det är tillgängligt.

stderr: undefined | string | Buffer

Egenskapsvärde

undefined | string | Buffer

stdout

Fångade standardutdata när det var tillgängligt.

stdout: undefined | string | Buffer

Egenskapsvärde

undefined | string | Buffer

Information om ärvda egenskaper

message 

message: string

Egenskapsvärde

string

ärvd från Error.message

name 

name: string

Egenskapsvärde

string

ärvd från Error.name

stack 

stack?: string

Egenskapsvärde

string

ärvd från Error.stack

stackTraceLimit

Egenskapen Error.stackTraceLimit specificerar antalet stackramar som samlas in av en stackspårning (oavsett om de genereras av new Error().stack eller Error.captureStackTrace(obj)).

Standardvärdet är 10 men kan sättas till vilket giltigt JavaScript-nummer som helst. Ändringar påverkar alla stackspår som fångas efter att värdet har ändrats.

Om stackspår sätts till ett icke-talvärde, eller till ett negativt tal, kommer stackspår inte att fånga några bildrutor.

static stackTraceLimit: number

Egenskapsvärde

number

Ärvt från Error.stackTraceLimit

Ärvd metodinformation

captureStackTrace(object, Function)

Skapar en .stack egenskap på targetObject, som när den nås returnerar en sträng som representerar platsen i koden där anropades Error.captureStackTrace() .

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

Den första raden i spåret kommer att prefixeras med ${myObject.name}: ${myObject.message}.

Det valfria constructorOpt argumentet accepterar en funktion. Om det ges kommer alla ramar ovanför constructorOpt, inklusive constructorOpt, att utelämnas från den genererade stackspårningen.

Argumentet constructorOpt är användbart för att dölja implementeringsdetaljer om felgenerering för användaren. Till exempel:

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)

Parametrar

targetObject

object

constructorOpt

Function

Ärvt från Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parametrar

err

Error

stackTraces

CallSite[]

Returer

any

Ärvt från Error.prepareStackTrace