ProcessError class

Pakket:
@azure/core-process

Een fout die wordt opgeroepen tijdens het oplossen of uitvoeren van een proces.

De vastgelegde output is niet opsombaar, dus gewone logging en serialisatie maken deze niet per ongeluk bloot.

Uitbreiding

Error

Constructors

ProcessError(string, ProcessErrorOptions)

Dat veroorzaakt een procesfout.

Eigenschappen

code

De foutcode van het besturingssysteem of de uitgangscode van het proces.
killed

Of het proces werd beëindigd.
signal

Het signaal dat het proces beëindigde.
stderr

Standaard fout vastgelegd, indien beschikbaar.
stdout

Standaard output vastgelegd, wanneer beschikbaar.

Overgenomen eigenschappen

message
name
stack
stackTraceLimit

De Error.stackTraceLimit eigenschap specificeert het aantal stackframes dat door een stacktrace wordt verzameld (of het nu wordt gegenereerd door new Error().stack of Error.captureStackTrace(obj)).

De standaardwaarde is 10 , maar kan worden ingesteld op elk geldig JavaScript-nummer. Wijzigingen beïnvloeden elke stacktrace die wordt vastgelegd nadat de waarde is gewijzigd.

Als ze worden ingesteld op een niet-getalwaarde, of op een negatief getal, zullen stacktraces geen frames vastleggen.

Overgenomen methoden

captureStackTrace(object, Function)

Maakt een .stack eigenschap aan op targetObject, die bij benadering een string teruggeeft die de locatie in de code waarop Error.captureStackTrace() werd aangeroepen de locatie vertegenwoordigt.

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

De eerste regel van de trace wordt voorafgegaan door ${myObject.name}: ${myObject.message}.

Het optionele constructorOpt argument accepteert een functie. Als gegeven, worden alle frames boven constructorOpt, inclusief constructorOpt, weggelaten uit de gegenereerde stacktrace.

Het constructorOpt argument is nuttig om implementatiedetails van foutgeneratie voor de gebruiker te verbergen. Bijvoorbeeld:

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

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

Constructordetails

ProcessError(string, ProcessErrorOptions)

Dat veroorzaakt een procesfout.

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

Parameters

message

string

Een bericht dat geen commandoargumenten of output bevat.

options
ProcessErrorOptions

Details van gestructureerde procesfouten.

Eigenschapdetails

code

De foutcode van het besturingssysteem of de uitgangscode van het proces.

code: null | string | number

Waarde van eigenschap

null | string | number

killed

Of het proces werd beëindigd.

killed: boolean

Waarde van eigenschap

boolean

signal

Het signaal dat het proces beëindigde.

signal: null | Signals

Waarde van eigenschap

null | Signals

stderr

Standaard fout vastgelegd, indien beschikbaar.

stderr: undefined | string | Buffer

Waarde van eigenschap

undefined | string | Buffer

stdout

Standaard output vastgelegd, wanneer beschikbaar.

stdout: undefined | string | Buffer

Waarde van eigenschap

undefined | string | Buffer

Details van overgenomen eigenschap

message 

message: string

Waarde van eigenschap

string

overgenomen van Error.message

name 

name: string

Waarde van eigenschap

string

overgenomen van Error.name

stack 

stack?: string

Waarde van eigenschap

string

overgenomen van Error.stack

stackTraceLimit

De Error.stackTraceLimit eigenschap specificeert het aantal stackframes dat door een stacktrace wordt verzameld (of het nu wordt gegenereerd door new Error().stack of Error.captureStackTrace(obj)).

De standaardwaarde is 10 , maar kan worden ingesteld op elk geldig JavaScript-nummer. Wijzigingen beïnvloeden elke stacktrace die wordt vastgelegd nadat de waarde is gewijzigd.

Als ze worden ingesteld op een niet-getalwaarde, of op een negatief getal, zullen stacktraces geen frames vastleggen.

static stackTraceLimit: number

Waarde van eigenschap

number

Geërfd van Error.stackTraceLimit

Details overgenomen methode

captureStackTrace(object, Function)

Maakt een .stack eigenschap aan op targetObject, die bij benadering een string teruggeeft die de locatie in de code waarop Error.captureStackTrace() werd aangeroepen de locatie vertegenwoordigt.

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

De eerste regel van de trace wordt voorafgegaan door ${myObject.name}: ${myObject.message}.

Het optionele constructorOpt argument accepteert een functie. Als gegeven, worden alle frames boven constructorOpt, inclusief constructorOpt, weggelaten uit de gegenereerde stacktrace.

Het constructorOpt argument is nuttig om implementatiedetails van foutgeneratie voor de gebruiker te verbergen. Bijvoorbeeld:

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)

Parameters

targetObject

object

constructorOpt

Function

Geërfd van Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parameters

err

Error

stackTraces

CallSite[]

Retouren

any

Geërfd van Error.prepareStackTrace