Edit

Share via


InteractionRequiredAuthError class

Error thrown when user interaction is required.

Extends

Constructors

InteractionRequiredAuthError(string, string, string, string, string, string, string, string)

Properties

claims

https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-common/docs/claims-challenge.md

A string with extra claims needed for the token request to succeed web site: redirect the user to the authorization page and set the extra claims web api: include the claims in the WWW-Authenticate header that are sent back to the client so that it knows to request a token with the extra claims desktop application or browser context: include the claims when acquiring the token interactively app to app context (client_credentials): include the claims in the AcquireTokenByClientCredential request

errorNo

Server error number;

timestamp

The time the error occured at

traceId

TraceId associated with the error

Inherited Properties

correlationId

CorrelationId associated with the error

errorCode

Short string denoting error

errorMessage

Detailed description of error

message
name
stack
stackTraceLimit

The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by new Error().stack or Error.captureStackTrace(obj)).

The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.

If set to a non-number value, or set to a negative number, stack traces will not capture any frames.

subError

Describes the subclass of an error

Inherited Methods

captureStackTrace(object, Function)

Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

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

The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

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

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

setCorrelationId(string)

Constructor Details

InteractionRequiredAuthError(string, string, string, string, string, string, string, string)

new InteractionRequiredAuthError(errorCode?: string, errorMessage?: string, subError?: string, timestamp?: string, traceId?: string, correlationId?: string, claims?: string, errorNo?: string)

Parameters

errorCode

string

errorMessage

string

subError

string

timestamp

string

traceId

string

correlationId

string

claims

string

errorNo

string

Property Details

claims

https://github.com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-common/docs/claims-challenge.md

A string with extra claims needed for the token request to succeed web site: redirect the user to the authorization page and set the extra claims web api: include the claims in the WWW-Authenticate header that are sent back to the client so that it knows to request a token with the extra claims desktop application or browser context: include the claims when acquiring the token interactively app to app context (client_credentials): include the claims in the AcquireTokenByClientCredential request

claims: string

Property Value

string

errorNo

Server error number;

errorNo?: string

Property Value

string

timestamp

The time the error occured at

timestamp: string

Property Value

string

traceId

TraceId associated with the error

traceId: string

Property Value

string

Inherited Property Details

correlationId

CorrelationId associated with the error

correlationId: string

Property Value

string

Inherited From AuthError.correlationId

errorCode

Short string denoting error

errorCode: string

Property Value

string

Inherited From AuthError.errorCode

errorMessage

Detailed description of error

errorMessage: string

Property Value

string

Inherited From AuthError.errorMessage

message

message: string

Property Value

string

Inherited From AuthError.message

name

name: string

Property Value

string

Inherited From AuthError.name

stack

stack?: string

Property Value

string

Inherited From AuthError.stack

stackTraceLimit

The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by new Error().stack or Error.captureStackTrace(obj)).

The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.

If set to a non-number value, or set to a negative number, stack traces will not capture any frames.

static stackTraceLimit: number

Property Value

number

Inherited From AuthError.stackTraceLimit

subError

Describes the subclass of an error

subError: string

Property Value

string

Inherited From AuthError.subError

Inherited Method Details

captureStackTrace(object, Function)

Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

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

The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

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)

Parameters

targetObject

object

constructorOpt

Function

Inherited From AuthError.captureStackTrace

prepareStackTrace(Error, CallSite[])

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

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

Parameters

err

Error

stackTraces

CallSite[]

Returns

any

Inherited From AuthError.prepareStackTrace

setCorrelationId(string)

function setCorrelationId(correlationId: string)

Parameters

correlationId

string

Inherited From AuthError.setCorrelationId