Udostępnij przez

MessagingError class

Pakiet:
@azure/core-amqp

Opisuje klasę podstawową dla błędu obsługi komunikatów.

Rozszerzenie

Error

Konstruktory

MessagingError(string, Error)

Właściwości

address

Adres, do którego połączenie sieciowe nie powiodło się. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.
code

Etykieta ciągu identyfikująca błąd.
errno

Podany przez system numer błędu. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.
info

Dodatkowe szczegóły dotyczące błędu.
name

Nazwa błędu. Wartość domyślna: "MessagingError".
port

Niedostępny port połączenia sieciowego. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.
retryable

Opisuje, czy błąd można ponowić próbę. Wartość domyślna: true.
syscall

Nazwa wywołania systemowego, które wyzwoliło błąd. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.

Właściwości dziedziczone

message
stack
stackTraceLimit

Właściwość Error.stackTraceLimit określa liczbę ramek stosu zebranych przez ślad stosu (niezależnie od tego, czy jest generowany przez new Error().stack lub Error.captureStackTrace(obj)).

Wartość domyślna to 10 ale może być ustawiona na dowolny prawidłowy numer JavaScript. Zmiany będą miały wpływ na wszystkie ślady stosu przechwycone po zmianie wartości.

Jeśli ustawiona jest wartość inna niż liczba lub liczba ujemna, ślady stosu nie będą przechwytywać żadnych ramek.

Metody dziedziczone

captureStackTrace(object, Function)

Tworzy właściwość .stack w programie targetObject, która po uzyskaniu dostępu zwraca ciąg reprezentujący lokalizację w kodzie, w którym Error.captureStackTrace() została wywołana.

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

Pierwszy wiersz śladu będzie poprzedzony prefiksem ${myObject.name}: ${myObject.message}.

constructorOpt Opcjonalny argument akceptuje funkcję. Jeśli zostanie podana, wszystkie klatki powyżej constructorOpt, w tym constructorOpt, zostaną pominięte w wygenerowanym śladzie stosu.

Argument constructorOpt jest przydatny do ukrywania szczegółów implementacji generowania błędów przed użytkownikiem. Przykład:

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

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

Szczegóły konstruktora

MessagingError(string, Error) 

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

Parametry

message

string

Komunikat o błędzie zawierający więcej informacji o błędzie.

originalError

Error

Błąd, którego właściwości zostaną skopiowane do błędu MessagingError, jeśli właściwość jest zgodna z właściwością znalezioną w Node.js SystemError.

Szczegóły właściwości

address

Adres, do którego połączenie sieciowe nie powiodło się. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.

address?: string

Wartość właściwości

string

code

Etykieta ciągu identyfikująca błąd.

code?: string

Wartość właściwości

string

errno

Podany przez system numer błędu. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.

errno?: string | number

Wartość właściwości

string | number

info

Dodatkowe szczegóły dotyczące błędu.

info?: any

Wartość właściwości

any

name

Nazwa błędu. Wartość domyślna: "MessagingError".

name: string

Wartość właściwości

string

port

Niedostępny port połączenia sieciowego. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.

port?: number

Wartość właściwości

number

retryable

Opisuje, czy błąd można ponowić próbę. Wartość domyślna: true.

retryable: boolean

Wartość właściwości

boolean

syscall

Nazwa wywołania systemowego, które wyzwoliło błąd. Występuje tylko wtedy, gdy wystąpienie MessagingError zostało utworzone za pomocą Node.js SystemError.

syscall?: string

Wartość właściwości

string

Szczegóły właściwości dziedziczonej

message 

message: string

Wartość właściwości

string

dziedziczone z Error.message

stack 

stack?: string

Wartość właściwości

string

dziedziczone z Error.stack

stackTraceLimit

Właściwość Error.stackTraceLimit określa liczbę ramek stosu zebranych przez ślad stosu (niezależnie od tego, czy jest generowany przez new Error().stack lub Error.captureStackTrace(obj)).

Wartość domyślna to 10 ale może być ustawiona na dowolny prawidłowy numer JavaScript. Zmiany będą miały wpływ na wszystkie ślady stosu przechwycone po zmianie wartości.

Jeśli ustawiona jest wartość inna niż liczba lub liczba ujemna, ślady stosu nie będą przechwytywać żadnych ramek.

static stackTraceLimit: number

Wartość właściwości

number

dziedziczone z Error.stackTraceLimit

Szczegóły metody dziedziczonej

captureStackTrace(object, Function)

Tworzy właściwość .stack w programie targetObject, która po uzyskaniu dostępu zwraca ciąg reprezentujący lokalizację w kodzie, w którym Error.captureStackTrace() została wywołana.

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

Pierwszy wiersz śladu będzie poprzedzony prefiksem ${myObject.name}: ${myObject.message}.

constructorOpt Opcjonalny argument akceptuje funkcję. Jeśli zostanie podana, wszystkie klatki powyżej constructorOpt, w tym constructorOpt, zostaną pominięte w wygenerowanym śladzie stosu.

Argument constructorOpt jest przydatny do ukrywania szczegółów implementacji generowania błędów przed użytkownikiem. Przykład:

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)

Parametry

targetObject

object

constructorOpt

Function

dziedziczone z Error.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parametry

err

Error

stackTraces

CallSite[]

Zwraca

any

dziedziczone z Error.prepareStackTrace