RestError class

Ein benutzerdefinierter Fehlertyp für fehlgeschlagene Pipelineanforderungen.

Extends

Error

Konstruktoren

RestError(string, RestErrorOptions)

Eigenschaften

code

Der Code des Fehlers selbst (verwenden Sie statisch bei RestError, falls möglich.)

details

Bonuseigenschaft, die von der Wurfwebsite festgelegt wird.

PARSE_ERROR

Dies bedeutet, dass beim Analysieren der Antwort vom Server ein Fehler aufgetreten ist. Möglicherweise ist sie falsch formatiert.

request

Die Anforderung, die gestellt wurde.

REQUEST_SEND_ERROR

Beim Stellen der Anforderung ist ein Fehler aufgetreten. Dies bedeutet, dass die tatsächliche Anforderung aus irgendeinem Grund fehlgeschlagen ist, z. B. ein DNS-Problem oder die Verbindung verloren geht.

response

Die empfangene Antwort (falls vorhanden.)

statusCode

Der HTTP-Statuscode der Anforderung (falls zutreffend.)

Geerbte Eigenschaften

message
name
stack
stackTraceLimit

Die Error.stackTraceLimit Eigenschaft gibt die Anzahl der Stack-Frames an, die von einem Stack-Trace erfasst werden (unabhängig davon, ob sie von oder new Error().stackgeneriert wurdenError.captureStackTrace(obj)).

Der Standardwert ist 10 , kann aber auf eine beliebige gültige JavaScript-Nummer gesetzt werden. Änderungen wirken sich auf alle Stack-Traces aus, die nach der Änderung des Werts erfasst wurden.

Wenn dieser Wert auf einen Wert festgelegt ist, der keine Zahl ist, oder auf eine negative Zahl, werden bei Stapelüberwachungen keine Frames erfasst.

Geerbte Methoden

captureStackTrace(object, Function)

Erstellt eine .stack Eigenschaft auf targetObject, die beim Zugriff eine Zeichenfolge zurückgibt, die die Position im Code darstellt, an der Error.captureStackTrace() aufgerufen wurde.

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

Der ersten Zeile der Ablaufverfolgung wird das ${myObject.name}: ${myObject.message}Präfix .

Das optionale constructorOpt Argument akzeptiert eine Funktion. Falls angegeben, werden alle Frames über constructorOpt, einschließlich constructorOpt, aus dem generierten Stack-Trace ausgelassen.

Das constructorOpt Argument ist nützlich, um Implementierungsdetails der Fehlergenerierung vor dem Benutzer zu verbergen. Beispiel:

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

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

Details zum Konstruktor

RestError(string, RestErrorOptions)

new RestError(message: string, options?: RestErrorOptions)

Parameter

message

string

Details zur Eigenschaft

code

Der Code des Fehlers selbst (verwenden Sie statisch bei RestError, falls möglich.)

code?: string

Eigenschaftswert

string

details

Bonuseigenschaft, die von der Wurfwebsite festgelegt wird.

details?: unknown

Eigenschaftswert

unknown

PARSE_ERROR

Dies bedeutet, dass beim Analysieren der Antwort vom Server ein Fehler aufgetreten ist. Möglicherweise ist sie falsch formatiert.

static PARSE_ERROR: string

Eigenschaftswert

string

request

Die Anforderung, die gestellt wurde.

request?: PipelineRequest

Eigenschaftswert

REQUEST_SEND_ERROR

Beim Stellen der Anforderung ist ein Fehler aufgetreten. Dies bedeutet, dass die tatsächliche Anforderung aus irgendeinem Grund fehlgeschlagen ist, z. B. ein DNS-Problem oder die Verbindung verloren geht.

static REQUEST_SEND_ERROR: string

Eigenschaftswert

string

response

Die empfangene Antwort (falls vorhanden.)

response?: PipelineResponse

Eigenschaftswert

statusCode

Der HTTP-Statuscode der Anforderung (falls zutreffend.)

statusCode?: number

Eigenschaftswert

number

Geerbte Eigenschaftsdetails

message

message: string

Eigenschaftswert

string

von Error.message geerbt

name

name: string

Eigenschaftswert

string

geerbt von Error.name

stack

stack?: string

Eigenschaftswert

string

geerbt von Error.stack

stackTraceLimit

Die Error.stackTraceLimit Eigenschaft gibt die Anzahl der Stack-Frames an, die von einem Stack-Trace erfasst werden (unabhängig davon, ob sie von oder new Error().stackgeneriert wurdenError.captureStackTrace(obj)).

Der Standardwert ist 10 , kann aber auf eine beliebige gültige JavaScript-Nummer gesetzt werden. Änderungen wirken sich auf alle Stack-Traces aus, die nach der Änderung des Werts erfasst wurden.

Wenn dieser Wert auf einen Wert festgelegt ist, der keine Zahl ist, oder auf eine negative Zahl, werden bei Stapelüberwachungen keine Frames erfasst.

static stackTraceLimit: number

Eigenschaftswert

number

geerbt von Error.stackTraceLimit

Details zur geerbten Methode

captureStackTrace(object, Function)

Erstellt eine .stack Eigenschaft auf targetObject, die beim Zugriff eine Zeichenfolge zurückgibt, die die Position im Code darstellt, an der Error.captureStackTrace() aufgerufen wurde.

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

Der ersten Zeile der Ablaufverfolgung wird das ${myObject.name}: ${myObject.message}Präfix .

Das optionale constructorOpt Argument akzeptiert eine Funktion. Falls angegeben, werden alle Frames über constructorOpt, einschließlich constructorOpt, aus dem generierten Stack-Trace ausgelassen.

Das constructorOpt Argument ist nützlich, um Implementierungsdetails der Fehlergenerierung vor dem Benutzer zu verbergen. Beispiel:

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)

Parameter

targetObject

object

constructorOpt

Function

geerbt von Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parameter

err

Error

stackTraces

CallSite[]

Gibt zurück

any

Geerbt von Error.prepareStackTrace