Skip to content

Class: E_NOT_AN_ENCODED_VALUE ​

Exception thrown when attempting to decode a value that is not a valid encoded value. This indicates the input string is not in the expected encoded format.

Extends ​

Constructors ​

Constructor ​

ts
new E_NOT_AN_ENCODED_VALUE(value: string): E_NOT_AN_ENCODED_VALUE;

Creates a new E_NOT_AN_ENCODED_VALUE exception.

Parameters ​

ParameterTypeDescription
valuestringThe string value that is not a valid encoded value.

Returns ​

E_NOT_AN_ENCODED_VALUE

Overrides ​

ts
BaseException.constructor;

Properties ​

PropertyModifierTypeDescriptionOverridesInherited from
cause?publicunknown--BaseException.cause
code?publicstringA machine readable error code. This will allow the error handling logic to narrow down exceptions based upon the error code.-BaseException.code
help?publicstringOptional help description for the error. You can use it to define additional human readable information for the error.-BaseException.help
messagepublicstring--BaseException.message
namepublicstringName of the class that raised the exception.-BaseException.name
stack?publicstring--BaseException.stack
statuspublicnumberA status code for the error. Usually helpful when converting errors to HTTP responses.-BaseException.status
codestaticstring-BaseException.code-
help?staticstringDefine the error metadata as static properties to avoid setting them repeatedly on the error instance-BaseException.help
message?staticstring--BaseException.message
stackTraceLimitstaticnumberThe 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.-BaseException.stackTraceLimit
statusstaticnumber-BaseException.status-

Accessors ​

[toStringTag] ​

Get Signature ​

ts
get toStringTag: string;

Returns the constructor name for the Symbol.toStringTag property.

Returns ​

string

The name of the exception class.

Inherited from ​

BaseException.[toStringTag]

Methods ​

toString() ​

ts
toString(): string;

Returns a string representation of the exception. Includes the error code in brackets if available.

Returns ​

string

A formatted string representation of the exception.

Inherited from ​

BaseException.toString


captureStackTrace() ​

ts
static captureStackTrace(targetObject: object, constructorOpt?: Function): void;

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

js
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:

js
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();

Parameters ​

ParameterType
targetObjectobject
constructorOpt?Function

Returns ​

void

Inherited from ​

ts
BaseException.captureStackTrace;

isError() ​

ts
static isError(error: unknown): error is Error;

Indicates whether the argument provided is a built-in Error instance or not.

Parameters ​

ParameterType
errorunknown

Returns ​

error is Error

Inherited from ​

ts
BaseException.isError;

prepareStackTrace() ​

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

Parameters ​

ParameterType
errError
stackTracesCallSite[]

Returns ​

any

See ​

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

Inherited from ​

ts
BaseException.prepareStackTrace;