Compartir a través de


MessagingError class

Describe la clase base para Error de mensajería.

Extends

Error

Constructores

MessagingError(string, Error)

Propiedades

address

Dirección a la que se produjo un error en la conexión de red. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

code

Etiqueta de cadena que identifica el error.

errno

Número de error proporcionado por el sistema. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

info

Detalles adicionales sobre el error.

name

Nombre del error. Valor predeterminado: "MessagingError".

port

Puerto de conexión de red no disponible. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

retryable

Describe si el error se puede reintentar. Valor predeterminado: true.

syscall

Nombre de la llamada del sistema que desencadenó el error. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

Propiedades heredadas

message
stack
stackTraceLimit

La Error.stackTraceLimit propiedad especifica el número de marcos de pila recopilados por un seguimiento de pila (ya sea generado por new Error().stack o Error.captureStackTrace(obj)).

El valor predeterminado es 10 pero se puede establecer en cualquier número de JavaScript válido. Los cambios afectarán a cualquier seguimiento de pila capturado después de que se haya cambiado el valor.

Si se establece en un valor que no es un número, o se establece en un número negativo, los seguimientos de pila no capturarán ningún fotograma.

Métodos heredados

captureStackTrace(object, Function)

Crea una .stack propiedad en targetObject, que, cuando se tiene acceso, devuelve una cadena que representa la ubicación en el código en el que Error.captureStackTrace() se llamó.

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

La primera línea de la traza tendrá el prefijo ${myObject.name}: ${myObject.message}.

El argumento opcional constructorOpt acepta una función. Si se proporciona, todos los fotogramas anteriores constructorOpt, incluido constructorOpt, se omitirán del seguimiento de pila generado.

El constructorOpt argumento es útil para ocultar al usuario los detalles de implementación de la generación de errores. Por ejemplo:

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

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

Detalles del constructor

MessagingError(string, Error)

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

Parámetros

message

string

Mensaje de error que proporciona más información sobre el error.

originalError

Error

Error cuyas propiedades se copiarán en MessagingError si la propiedad coincide con una encontrada en el Node.js SystemError.

Detalles de las propiedades

address

Dirección a la que se produjo un error en la conexión de red. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

address?: string

Valor de propiedad

string

code

Etiqueta de cadena que identifica el error.

code?: string

Valor de propiedad

string

errno

Número de error proporcionado por el sistema. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

errno?: string | number

Valor de propiedad

string | number

info

Detalles adicionales sobre el error.

info?: any

Valor de propiedad

any

name

Nombre del error. Valor predeterminado: "MessagingError".

name: string

Valor de propiedad

string

port

Puerto de conexión de red no disponible. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

port?: number

Valor de propiedad

number

retryable

Describe si el error se puede reintentar. Valor predeterminado: true.

retryable: boolean

Valor de propiedad

boolean

syscall

Nombre de la llamada del sistema que desencadenó el error. Solo está presente si se creó una instancia del MessagingError con un Node.js SystemError.

syscall?: string

Valor de propiedad

string

Detalles de las propiedades heredadas

message

message: string

Valor de propiedad

string

Heredado de Error.message

stack

stack?: string

Valor de propiedad

string

heredado de Error.stack

stackTraceLimit

La Error.stackTraceLimit propiedad especifica el número de marcos de pila recopilados por un seguimiento de pila (ya sea generado por new Error().stack o Error.captureStackTrace(obj)).

El valor predeterminado es 10 pero se puede establecer en cualquier número de JavaScript válido. Los cambios afectarán a cualquier seguimiento de pila capturado después de que se haya cambiado el valor.

Si se establece en un valor que no es un número, o se establece en un número negativo, los seguimientos de pila no capturarán ningún fotograma.

static stackTraceLimit: number

Valor de propiedad

number

heredado de Error.stackTraceLimit

Detalles de los métodos heredados

captureStackTrace(object, Function)

Crea una .stack propiedad en targetObject, que, cuando se tiene acceso, devuelve una cadena que representa la ubicación en el código en el que Error.captureStackTrace() se llamó.

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

La primera línea de la traza tendrá el prefijo ${myObject.name}: ${myObject.message}.

El argumento opcional constructorOpt acepta una función. Si se proporciona, todos los fotogramas anteriores constructorOpt, incluido constructorOpt, se omitirán del seguimiento de pila generado.

El constructorOpt argumento es útil para ocultar al usuario los detalles de implementación de la generación de errores. Por ejemplo:

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)

Parámetros

targetObject

object

constructorOpt

Function

heredado de Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parámetros

err

Error

stackTraces

CallSite[]

Devoluciones

any

heredado de Error.prepareStackTrace