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


CallError class

Ошибка, возникаемая из методов API с отслеживанием состояния.

Extends

Error

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

CallError(CallErrorTarget, Error, Date)

должен быть (innerError как CommunicationServicesError)

Свойства

code

Первичный код для ошибки вызова

innerError

Ошибка, возникаемая методом пакета SDK сбоем.

subCode

Подкод для вызывающей ошибки

target

Целевой объект метода API, который завершился сбоем.

timestamp

Метка времени, добавленная в ошибку слоя с отслеживанием состояния.

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

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

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

CallError(CallErrorTarget, Error, Date)

должен быть (innerError как CommunicationServicesError)

new CallError(target: CallErrorTarget, innerError: Error, timestamp?: Date)

Параметры

innerError

Error

timestamp

Date

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

code

Первичный код для ошибки вызова

code?: number

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

number

innerError

Ошибка, возникаемая методом пакета SDK сбоем.

innerError: Error

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

Error

subCode

Подкод для вызывающей ошибки

subCode?: number

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

number

target

Целевой объект метода API, который завершился сбоем.

target: CallErrorTarget

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

timestamp

Метка времени, добавленная в ошибку слоя с отслеживанием состояния.

timestamp: Date

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

Date

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

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)

Создает свойство .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