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


AuthenticationRequiredError class

Ошибка, используемая для принудительной проверки подлинности после попытки автоматического получения маркера.

Extends

Error

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

AuthenticationRequiredError(AuthenticationRequiredErrorOptions)

Свойства

getTokenOptions

Параметры, переданные запросу getToken.

scopes

Список областей, для которых маркер будет иметь доступ.

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

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

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

AuthenticationRequiredError(AuthenticationRequiredErrorOptions)

new AuthenticationRequiredError(options: AuthenticationRequiredErrorOptions)

Параметры

options
AuthenticationRequiredErrorOptions

Необязательные параметры. Можно указать сообщение. Можно также указать GetTokenOptions запроса, чтобы упростить связывание ошибки с полученными параметрами.

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

getTokenOptions

Параметры, переданные запросу getToken.

getTokenOptions?: GetTokenOptions

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

scopes

Список областей, для которых маркер будет иметь доступ.

scopes: string[]

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

string[]

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

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