RestError class

Een aangepast fouttype voor mislukte pijplijnaanvragen.

Uitbreiding

Error

Constructors

RestError(string, RestErrorOptions)

Eigenschappen

code

De code van de fout zelf (gebruik indien mogelijk statics in RestError.)

details

Bonuseigenschap ingesteld door de gooisite.

PARSE_ERROR

Dit betekent dat het parseren van het antwoord van de server is mislukt. Het is misschien onjuist gevormd.

request

De aanvraag die is ingediend.

REQUEST_SEND_ERROR

Er is iets misgegaan bij het indienen van de aanvraag. Dit betekent dat de werkelijke aanvraag om een of andere reden is mislukt, zoals een DNS-probleem of dat de verbinding is verbroken.

response

Het antwoord is ontvangen (indien van toepassing.)

statusCode

De HTTP-statuscode van de aanvraag (indien van toepassing.)

Overgenomen eigenschappen

message
name
stack
stackTraceLimit

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

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

Als ze zijn ingesteld op een niet-getalwaarde of op een negatief getal, worden er geen frames vastgelegd.

Overgenomen methoden

captureStackTrace(object, Function)

Hiermee maakt u een .stack eigenschap op targetObject, die bij het openen een tekenreeks retourneert die de locatie vertegenwoordigt in de code waarop Error.captureStackTrace() is aangeroepen.

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 ze worden gegeven, worden alle bovenstaande constructorOptframes , inclusief constructorOpt, weggelaten uit de gegenereerde stacktrace.

Het constructorOpt argument is handig om implementatiedetails van het genereren van fouten 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

RestError(string, RestErrorOptions)

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

Parameters

message

string

Eigenschapdetails

code

De code van de fout zelf (gebruik indien mogelijk statics in RestError.)

code?: string

Waarde van eigenschap

string

details

Bonuseigenschap ingesteld door de gooisite.

details?: unknown

Waarde van eigenschap

unknown

PARSE_ERROR

Dit betekent dat het parseren van het antwoord van de server is mislukt. Het is misschien onjuist gevormd.

static PARSE_ERROR: string

Waarde van eigenschap

string

request

De aanvraag die is ingediend.

request?: PipelineRequest

Waarde van eigenschap

REQUEST_SEND_ERROR

Er is iets misgegaan bij het indienen van de aanvraag. Dit betekent dat de werkelijke aanvraag om een of andere reden is mislukt, zoals een DNS-probleem of dat de verbinding is verbroken.

static REQUEST_SEND_ERROR: string

Waarde van eigenschap

string

response

Het antwoord is ontvangen (indien van toepassing.)

response?: PipelineResponse

Waarde van eigenschap

statusCode

De HTTP-statuscode van de aanvraag (indien van toepassing.)

statusCode?: number

Waarde van eigenschap

number

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 geeft het aantal stackframes aan dat wordt verzameld door een stacktrace (gegenereerd door new Error().stack of Error.captureStackTrace(obj)).

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

Als ze zijn ingesteld op een niet-getalwaarde of op een negatief getal, worden er geen frames vastgelegd.

static stackTraceLimit: number

Waarde van eigenschap

number

overgenomen van Error.stackTraceLimit

Details overgenomen methode

captureStackTrace(object, Function)

Hiermee maakt u een .stack eigenschap op targetObject, die bij het openen een tekenreeks retourneert die de locatie vertegenwoordigt in de code waarop Error.captureStackTrace() is aangeroepen.

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 ze worden gegeven, worden alle bovenstaande constructorOptframes , inclusief constructorOpt, weggelaten uit de gegenereerde stacktrace.

Het constructorOpt argument is handig om implementatiedetails van het genereren van fouten 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

overgenomen 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

overgenomen van Error.prepareStackTrace