RestError class

Пакет:: @azure/core-https

Настраиваемый тип ошибки для неудачных запросов конвейера.

Extends: Error

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

Свойства

code	Код самой ошибки (при возможности используйте статические данные в RestError.)
details	Бонусное свойство, заданное сайтом броска.
PARSE_ERROR	Это означает, что сбой синтаксического анализа ответа с сервера. Возможно, это было неправильно сформировано.
request	Сделанный запрос.
REQUEST_SEND_ERROR	Что-то пошло не так при выполнении запроса. Это означает, что фактический запрос произошел сбоем по какой-то причине, например проблема DNS или потерянное соединение.
response	Полученный ответ (если таковой есть).)
statusCode	Код состояния HTTP запроса (если применимо.)

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

message
name
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

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

RestError(string, RestErrorOptions)

new RestError(message: string, options?: RestErrorOptions)

Параметры

message: string

options: RestErrorOptions

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

code

Код самой ошибки (при возможности используйте статические данные в RestError.)

code?: string

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

string

details

Бонусное свойство, заданное сайтом броска.

details?: unknown

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

unknown

PARSE_ERROR

Это означает, что сбой синтаксического анализа ответа с сервера. Возможно, это было неправильно сформировано.

static PARSE_ERROR: string

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

string

request

Сделанный запрос.

request?: PipelineRequest

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

PipelineRequest

REQUEST_SEND_ERROR

Что-то пошло не так при выполнении запроса. Это означает, что фактический запрос произошел сбоем по какой-то причине, например проблема DNS или потерянное соединение.

static REQUEST_SEND_ERROR: string

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

string

response

Полученный ответ (если таковой есть).)

response?: PipelineResponse

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

PipelineResponse

statusCode

Код состояния HTTP запроса (если применимо.)

statusCode?: number

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

number

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

message

message: string

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

string

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

name

name: string

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

string

унаследован от Error.name

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)

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

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

Аргумент 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

Обратная связь

Были ли сведения на этой странице полезными?