Поделиться через


MessagingError class

Описывает базовый класс для ошибки обмена сообщениями.

Extends

Error

Конструкторы

MessagingError(string, Error)

Свойства

address

Адрес, к которому произошел сбой сетевого подключения. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

code

Строка метки, идентифицирующая ошибку.

errno

Номер ошибки, предоставленный системой. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

info

Дополнительные сведения об ошибке.

name

Имя ошибки. Значение по умолчанию: MessagingError.

port

Недоступный порт сетевого подключения. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

retryable

Описывает, можно ли повторить ошибку. Значение по умолчанию: true.

syscall

Имя системного вызова, активировающего ошибку. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

Унаследованные свойства

message
stack
stackTraceLimit

Свойство Error.stackTraceLimit указывает количество кадров стека, собранных трассировкой стека (сгенерированной new Error().stack или Error.captureStackTrace(obj)).

Значение по умолчанию — 10 но может быть установлено на любой допустимый номер JavaScript. Изменения повлияют на любую трассировку стека, захваченную после изменения значения.

Если задано нечисловое значение или установлено отрицательное число, трассировки стека не будут захватывать кадры.

Наследуемые методы

captureStackTrace(object, Function)

Создает свойство .stack на targetObject, которое при доступе возвращает строку, представляющую местоположение в коде, в котором Error.captureStackTrace() был вызван.

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

Первая строка трассировки будет начинаться с префикса ${myObject.name}: ${myObject.message}.

Необязательный constructorOpt аргумент принимает функцию. Если указано, все кадры выше constructorOpt, включая constructorOpt, будут исключены из сгенерированной трассировки стека.

Аргумент constructorOpt полезен для сокрытия от пользователя деталей реализации генерации ошибки. Например:

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

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

Сведения о конструкторе

MessagingError(string, Error)

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

Параметры

message

string

Сообщение об ошибке, которое содержит дополнительные сведения об ошибке.

originalError

Error

Ошибка, свойства которой будут скопированы в MessagingError, если свойство совпадает со свойством, найденным на Node.js SystemError.

Сведения о свойстве

address

Адрес, к которому произошел сбой сетевого подключения. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

address?: string

Значение свойства

string

code

Строка метки, идентифицирующая ошибку.

code?: string

Значение свойства

string

errno

Номер ошибки, предоставленный системой. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

errno?: string | number

Значение свойства

string | number

info

Дополнительные сведения об ошибке.

info?: any

Значение свойства

any

name

Имя ошибки. Значение по умолчанию: MessagingError.

name: string

Значение свойства

string

port

Недоступный порт сетевого подключения. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

port?: number

Значение свойства

number

retryable

Описывает, можно ли повторить ошибку. Значение по умолчанию: true.

retryable: boolean

Значение свойства

boolean

syscall

Имя системного вызова, активировающего ошибку. Присутствует только в том случае, если экземпляр MessagingError был создан с помощью Node.js SystemError.

syscall?: string

Значение свойства

string

Сведения об унаследованном свойстве

message

message: string

Значение свойства

string

наследуется от Error.message

stack

stack?: string

Значение свойства

string

наследуется от Error.stack

stackTraceLimit

Свойство Error.stackTraceLimit указывает количество кадров стека, собранных трассировкой стека (сгенерированной new Error().stack или Error.captureStackTrace(obj)).

Значение по умолчанию — 10 но может быть установлено на любой допустимый номер JavaScript. Изменения повлияют на любую трассировку стека, захваченную после изменения значения.

Если задано нечисловое значение или установлено отрицательное число, трассировки стека не будут захватывать кадры.

static stackTraceLimit: number

Значение свойства

number

наследуется от Error.stackTraceLimit

Сведения о наследуемом методе

captureStackTrace(object, Function)

Создает свойство .stack на targetObject, которое при доступе возвращает строку, представляющую местоположение в коде, в котором Error.captureStackTrace() был вызван.

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

Первая строка трассировки будет начинаться с префикса ${myObject.name}: ${myObject.message}.

Необязательный constructorOpt аргумент принимает функцию. Если указано, все кадры выше constructorOpt, включая constructorOpt, будут исключены из сгенерированной трассировки стека.

Аргумент constructorOpt полезен для сокрытия от пользователя деталей реализации генерации ошибки. Например:

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)

Параметры

targetObject

object

constructorOpt

Function

наследуется от Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Параметры

err

Error

stackTraces

CallSite[]

Возвращаемое значение

any

наследуется от ошибки.prepareStackTrace