Compartir a través de


MessagingError class

Describe la clase base para Error de mensajería.

Extends

Error

Constructores

MessagingError(string)

Propiedades

condition

Condición de error.

info

Cualquier información de error adicional dada por el servicio.

name

Nombre del error. Valor predeterminado: "MessagingError".

retryable

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

translated

Se ha traducido el error. Valor predeterminado: true.

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)

new MessagingError(message: string)

Parámetros

message

string

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

Detalles de las propiedades

condition

Condición de error.

condition?: string

Valor de propiedad

string

info

Cualquier información de error adicional dada por el servicio.

info?: any

Valor de propiedad

any

name

Nombre del error. Valor predeterminado: "MessagingError".

name: string

Valor de propiedad

string

retryable

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

retryable: boolean

Valor de propiedad

boolean

translated

Se ha traducido el error. Valor predeterminado: true.

translated: boolean

Valor de propiedad

boolean

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