Skip to content

Class: ServiceUnavailableException ​

说明

本页由源码中的注释生成,内容为英文。

A service called by an HTTPServiceProxy gave no response: it could not be reached, it did not answer in time, or its answer was not a service response (the error page of a proxy in front of it…). Its cause is the error of the request when there is one, its service the address of the service. Its errno is E_SERVICE_UNAVAILABLE, its HTTP status 503. The failures of the actions themselves are thrown as ServiceInvokeException.

Extends ​

Constructors ​

Constructor ​

new ServiceUnavailableException(template, ...params): ServiceUnavailableException

Parameters ​

template ​

string

params ​

...any[]

Returns ​

ServiceUnavailableException

Inherited from ​

Exception.constructor

Constructor ​

new ServiceUnavailableException(message): ServiceUnavailableException

Parameters ​

message ​

string

Returns ​

ServiceUnavailableException

Inherited from ​

Exception.constructor

Constructor ​

new ServiceUnavailableException(error): ServiceUnavailableException

Parameters ​

error ​

Error

Returns ​

ServiceUnavailableException

Inherited from ​

Exception.constructor

Constructor ​

new ServiceUnavailableException(): ServiceUnavailableException

Returns ​

ServiceUnavailableException

Inherited from ​

Exception.constructor

Properties ​

appId ​

readonly appId: string

The ID of the application the exception was created in, "Unknown" before the application's options are loaded.

Inherited from ​

Exception.appId


appName ​

readonly appName: string

The name of the application the exception was created in, "Unknown" before the application's options are loaded.

Inherited from ​

Exception.appName


cause? ​

optional cause?: unknown

Inherited from ​

Exception.cause


err ​

readonly err: string

The name of the exception's class ('OrderNotFoundException'), a copy of name kept as an own property.

Inherited from ​

Exception.err


errMsg ​

readonly errMsg: string

The formatted message, a copy of message kept as an own property (sent with the error by the entrypoints).

Inherited from ​

Exception.errMsg


errno ​

errno: string | number

The error number or code identifying the error to the clients and the logs ('E_ORDER_NOT_FOUND'); each subclass sets it.

Overrides ​

Exception.errno


message ​

message: string

Inherited from ​

Exception.message


service? ​

optional service?: string

The address of the service called.


stack? ​

optional stack?: string

Inherited from ​

Exception.stack


stackTraceLimit ​

static stackTraceLimit: number

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.

Inherited from ​

Exception.stackTraceLimit


statusCode ​

readonly statusCode: number

The HTTP status the HTTP entrypoints reply with when the exception fails a request; a subclass overrides it (404 for a missing resource…).

Default ​

ts
500

Overrides ​

Exception.statusCode

Accessors ​

name ​

Get Signature ​

get name(): string

The name of the exception: the name of its class.

Returns ​

string

The class name.

Inherited from ​

Exception.name

Methods ​

captureStackTrace() ​

static captureStackTrace(targetObject, constructorOpt?): 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 ​

targetObject ​

object

constructorOpt? ​

Function

Returns ​

void

Inherited from ​

Exception.captureStackTrace


prepareStackTrace() ​

static prepareStackTrace(err, stackTraces): any

Parameters ​

err ​

Error

stackTraces ​

CallSite[]

Returns ​

any

See ​

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

Inherited from ​

Exception.prepareStackTrace

Released under the MIT License.