Dela via


MessagingError class

Beskriver basklassen för meddelandefel.

Extends

Error

Konstruktorer

MessagingError(string, Error)

Egenskaper

address

Adress som nätverksanslutningen misslyckades till. Presentera endast om MessagingError instansierades med en Node.js SystemError.

code

En strängetikett som identifierar felet.

errno

Systemspecifikt felnummer. Presentera endast om MessagingError instansierades med en Node.js SystemError.

info

Extra information om felet.

name

Felnamnet. Standardvärde: "MessagingError".

port

Den otillgängliga nätverksanslutningsporten. Presentera endast om MessagingError instansierades med en Node.js SystemError.

retryable

Beskriver om felet kan försökas igen. Standard: sant.

syscall

Namnet på systemanropet som utlöste felet. Presentera endast om MessagingError instansierades med en Node.js SystemError.

Ärvda egenskaper

message
stack
stackTraceLimit

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

Standardvärdet är 10 men kan ställas in på valfritt giltigt JavaScript-nummer. Ändringarna påverkar alla stackspårningar som samlas in efter att värdet har ändrats.

Om det är inställt på ett icke-numeriskt värde, eller inställt på ett negativt tal, kommer stackspårningar inte att samla in några bildrutor.

Ärvda metoder

captureStackTrace(object, Function)

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

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

Den första raden i spårningen föregås ${myObject.name}: ${myObject.message}av .

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

Argumentet constructorOpt är användbart för att dölja implementeringsinformation för felgenerering från 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

MessagingError(string, Error)

new MessagingError(message: string, originalError?: Error)

Parametrar

message

string

Felmeddelandet som innehåller mer information om felet.

originalError

Error

Ett fel vars egenskaper kommer att kopieras till MessagingError om egenskapen matchar en som finns på Node.js SystemError.

Egenskapsinformation

address

Adress som nätverksanslutningen misslyckades till. Presentera endast om MessagingError instansierades med en Node.js SystemError.

address?: string

Egenskapsvärde

string

code

En strängetikett som identifierar felet.

code?: string

Egenskapsvärde

string

errno

Systemspecifikt felnummer. Presentera endast om MessagingError instansierades med en Node.js SystemError.

errno?: string | number

Egenskapsvärde

string | number

info

Extra information om felet.

info?: any

Egenskapsvärde

any

name

Felnamnet. Standardvärde: "MessagingError".

name: string

Egenskapsvärde

string

port

Den otillgängliga nätverksanslutningsporten. Presentera endast om MessagingError instansierades med en Node.js SystemError.

port?: number

Egenskapsvärde

number

retryable

Beskriver om felet kan försökas igen. Standard: sant.

retryable: boolean

Egenskapsvärde

boolean

syscall

Namnet på systemanropet som utlöste felet. Presentera endast om MessagingError instansierades med en Node.js SystemError.

syscall?: string

Egenskapsvärde

string

Information om ärvda egenskaper

message

message: string

Egenskapsvärde

string

ärvd från Error.message

stack

stack?: string

Egenskapsvärde

string

ärvd från Error.stack

stackTraceLimit

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

Standardvärdet är 10 men kan ställas in på valfritt giltigt JavaScript-nummer. Ändringarna påverkar alla stackspårningar som samlas in efter att värdet har ändrats.

Om det är inställt på ett icke-numeriskt värde, eller inställt på ett negativt tal, kommer stackspårningar inte att samla in några bildrutor.

static stackTraceLimit: number

Egenskapsvärde

number

ärvd från Error.stackTraceLimit

Ärvd metodinformation

captureStackTrace(object, Function)

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

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

Den första raden i spårningen föregås ${myObject.name}: ${myObject.message}av .

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

Argumentet constructorOpt är användbart för att dölja implementeringsinformation för felgenerering från 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

ärvd 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

ärvd från Error.prepareStackTrace