Skip to main content

Class: Error

@ima/core.Error

The IMA application error extends the native Error with additional details that lead to the error and the HTTP status code to send to the client.

Hierarchy

Constructors

constructor

new Error(message, params?)

Parameters

NameType
messagestring
params?Object
params.cause?string | Error

Overrides

Error.constructor

Defined in

packages/core/src/error/Error.ts:8

Properties

cause

Optional cause: unknown

Inherited from

Error.cause

Defined in

node_modules/typescript/lib/lib.es2022.error.d.ts:24


message

message: string

Inherited from

Error.message

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1068


name

name: string

Inherited from

Error.name

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1067


stack

Optional stack: string

Inherited from

Error.stack

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1069


prepareStackTrace

Static Optional prepareStackTrace: (err: Error, stackTraces: CallSite[]) => any

Type declaration

▸ (err, stackTraces): any

Optional override for formatting stack traces

Parameters
NameType
errError
stackTracesCallSite[]
Returns

any

See

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

Inherited from

Error.prepareStackTrace

Defined in

node_modules/@types/node/globals.d.ts:11


stackTraceLimit

Static stackTraceLimit: number

Inherited from

Error.stackTraceLimit

Defined in

node_modules/@types/node/globals.d.ts:13

Methods

getHttpStatus

getHttpStatus(): number

Returns the HTTP status to send to the client.

If the error has occurred at the client-side, the status code is used to determine the error page to show to the user.

This method is a shorthand for the following code snippet: this.getParams().status || 500.

Returns

number

The HTTP status to send to the client.

See

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

Defined in

packages/core/src/error/Error.ts:24


getParams

getParams(): UnknownParameters

Returns the error parameters providing additional details about the error. The structure of the returned object is always situation-dependent, but the returned object usually contains the status: number field which represents the HTTP status to send to the client.

Returns

UnknownParameters

The route parameters of the route at which the error has occurred.

See

Error#getHttpStatus

Defined in

packages/core/src/error/Error.ts:39


isClientError

isClientError(): boolean

Tests, whether the specified error was caused by the client's action (for example wrong URL or request encoding).

Returns

boolean

true if the error was caused the action of the client.

Defined in

packages/core/src/error/Error.ts:50


isRedirection

isRedirection(): boolean

Tests, whether the specified error should lead to a redirect.

Returns

boolean

true if the error should cause a redirect.

Defined in

packages/core/src/error/Error.ts:59


captureStackTrace

Static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

NameType
targetObjectobject
constructorOpt?Function

Returns

void

Inherited from

Error.captureStackTrace

Defined in

node_modules/@types/node/globals.d.ts:4