Skip to content

@gala-chain/chaincode ∙ API

API > BatchPartialSuccessRequiredError

Class: BatchPartialSuccessRequiredError

Contents

Extends

  • ChainError

Constructors

new BatchPartialSuccessRequiredError(index, error)

new BatchPartialSuccessRequiredError(index, error): BatchPartialSuccessRequiredError

Parameters

▪ index: number

▪ error: GalaChainErrorResponse\<unknown>

Overrides

ChainError.constructor

Source

chaincode/src/contracts/GalaContract.ts:55

Properties

code

readonly code: ErrorCode

Overrides

ChainError.code

Source

chaincode/src/contracts/GalaContract.ts:53

key

readonly key: Uppercase\<string>

An upper case string to be used as a key do diagnose where the error comes from and help with regular development. It should not be used by client integrating with the chain since we don't guarantee it won't change. It is generated from original error class name.

Inherited from

ChainError.key

Source

chain-api/src/utils/error.ts:54

message

message: string

Inherited from

ChainError.message

Source

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

name

name: string

Inherited from

ChainError.name

Source

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

payload

readonly payload?: Record\<string, unknown>

Additional information to be used by

Inherited from

ChainError.payload

Source

chain-api/src/utils/error.ts:59

stack

stack?: string

Inherited from

ChainError.stack

Source

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

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

ChainError.stackTraceLimit

Source

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

Methods

andExec()

andExec(fn): ChainError

Allows to execute function getting as a parameter the current error.

Parameters

▪ fn: (e) => void

Returns

Inherited from

ChainError.andExec

Example

throw CommonChainError.objectNotFound(objectId).andExec((e) => {
  logger.error(e.message);
});

Source

chain-api/src/utils/error.ts:115

logError()

logError(logger): ChainError

Parameters

▪ logger: object

▪ logger.error

Inherited from

ChainError.logError

Source

chain-api/src/utils/error.ts:120

logWarn()

logWarn(logger): ChainError

Parameters

▪ logger: object

▪ logger.warn

Inherited from

ChainError.logWarn

Source

chain-api/src/utils/error.ts:125

map()

map(key, newError): ChainError

Maps ChainError to another chain error by error code if key param matches current error code or current diagnostic key. Otherwise, returns original error.

Useful in rethrowing an error or mapping an error to another one in catch clauses or catch methods in promises.

Parameters

▪ key: ErrorCode | ClassConstructor\<ChainError>

error code or error class to match

▪ newError: ChainError | (e) => ChainError

new error or a function to create the new error

Inherited from

ChainError.map

Source

chain-api/src/utils/error.ts:149

matches()

matches(key): boolean

Parameters

▪ key: ErrorCode | ClassConstructor\<ChainError>

Inherited from

ChainError.matches

Source

chain-api/src/utils/error.ts:130

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.

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

Parameters

▪ targetObject: object

▪ constructorOpt?: Function

Inherited from

ChainError.captureStackTrace

Source

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

from()

static from(e): ChainError

Parameters

▪ e: object & object

Inherited from

ChainError.from

Source

chain-api/src/utils/error.ts:169

ignore()

static ignore\<T>(e, key, defaultValue?): T

Recovers (mutes) ChainError to a specified return value or undefined.

Type parameters

▪ T = undefined

Parameters

▪ e: ChainError | object

▪ key: ErrorCode | ClassConstructor\<ChainError>

▪ defaultValue?: T

Returns

Inherited from

ChainError.ignore

Deprecated

Use ChainError.recover instead.

Source

chain-api/src/utils/error.ts:247

isChainError()

static isChainError(e): e is ChainError

Parameters

▪ e: undefined | object

Inherited from

ChainError.isChainError

Source

chain-api/src/utils/error.ts:165

map()

static map(e, key, newError): ChainError

Maps ChainError to another chain error by error code, or returns original error if no error code matches, or returns default chain error if a given parameter is not a ChainError instance.

Useful in rethrowing an error or mapping an error to another one in catch clauses or catch methods in promises.

Parameters

▪ e: ChainError | object

original error

▪ key: ErrorCode | ClassConstructor\<ChainError>

error code or error class to match

▪ newError: ChainError | (e) => ChainError

new error or a function to create the new error

Inherited from

ChainError.map

Source

chain-api/src/utils/error.ts:192

matches()

static matches(e, key): boolean

Parameters

▪ e: ChainError | object

▪ key: ErrorCode | ClassConstructor\<ChainError>

Inherited from

ChainError.matches

Source

chain-api/src/utils/error.ts:173

normalizedKey()

static normalizedKey(fn): Uppercase\<string>

Parameters

▪ fn: string | Function

Inherited from

ChainError.normalizedKey

Source

chain-api/src/utils/error.ts:81

prepareStackTrace()

static prepareStackTrace(err, stackTraces): any

Parameters

▪ err: Error

▪ stackTraces: CallSite[]

Returns

Inherited from

ChainError.prepareStackTrace

See

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

Source

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

recover()

static recover\<T>(e, key, defaultValue?): T

Recovers (mutes) ChainError to a specified return value or undefined.

If the error is a ChainError and matches the error code, the error is recovered and the specified return value is returned. Otherwise, the error is re-thrown.

For instance when you want to get an object from chain, and instead of throwing a NOT_FOUND error, you want to return undefined:

getObjectByKey(...)
  .catch((e) => CommonChainError.recover(e, ErrorCode.NOT_FOUND));

If you want to return a default value instead of undefined, you can do:

getObjectByKey(...)
  .catch((e) => CommonChainError.recover(e, ErrorCode.NOT_FOUND, defaultValue));

Type parameters

▪ T = undefined

Parameters

▪ e: ChainError | object

original error

▪ key: ErrorCode | ClassConstructor\<ChainError>

error code or error class to match

▪ defaultValue?: T

value to be returned if error code matches

Inherited from

ChainError.recover

Source

chain-api/src/utils/error.ts:230

withCode()

static withCode(code): ClassConstructor\<ChainError>

Parameters

▪ code: ErrorCode

Inherited from

ChainError.withCode

Source

chain-api/src/utils/error.ts:99