Skip to main content

Interface: IFailure

failure.v1.IFailure

Properties of a Failure.

Hierarchy​

Properties​

activityFailureInfo​

• Optional activityFailureInfo: null | $Properties

Failure activityFailureInfo

Inherited from​

$Properties.activityFailureInfo

applicationFailureInfo​

• Optional applicationFailureInfo: null | $Properties

Failure applicationFailureInfo

Inherited from​

$Properties.applicationFailureInfo

canceledFailureInfo​

• Optional canceledFailureInfo: null | $Properties

Failure canceledFailureInfo

Inherited from​

$Properties.canceledFailureInfo

cause​

• Optional cause: null | $Properties

Failure cause

Inherited from​

$Properties.cause

childWorkflowExecutionFailureInfo​

• Optional childWorkflowExecutionFailureInfo: null | $Properties

Failure childWorkflowExecutionFailureInfo

Inherited from​

$Properties.childWorkflowExecutionFailureInfo

encodedAttributes​

• Optional encodedAttributes: null | $Properties

Alternative way to supply message and stack_trace and possibly other attributes, used for encryption of errors originating in user code which might contain sensitive information. The encoded_attributes Payload could represent any serializable object, e.g. JSON object or a Failure proto message.

SDK authors:

  • The SDK should provide a default encodeFailureAttributes and decodeFailureAttributes implementation that:

  • Uses a JSON object to represent { message, stack_trace }.

  • Overwrites the original message with "Encoded failure" to indicate that more information could be extracted.

  • Overwrites the original stack_trace with an empty string.

  • The resulting JSON object is converted to Payload using the default PayloadConverter and should be processed by the user-provided PayloadCodec

  • If there's demand, we could allow overriding the default SDK implementation to encode other opaque Failure attributes. (-- api-linter: core::0203::optional=disabled --)

Inherited from​

$Properties.encodedAttributes

failureInfo​

• Optional failureInfo: "applicationFailureInfo" | "timeoutFailureInfo" | "canceledFailureInfo" | "terminatedFailureInfo" | "serverFailureInfo" | "resetWorkflowFailureInfo" | "activityFailureInfo" | "childWorkflowExecutionFailureInfo" | "nexusOperationExecutionFailureInfo" | "nexusHandlerFailureInfo"

Failure failureInfo

Inherited from​

$Properties.failureInfo

message​

• Optional message: null | string

Failure message

Inherited from​

$Properties.message

nexusHandlerFailureInfo​

• Optional nexusHandlerFailureInfo: null | $Properties

Failure nexusHandlerFailureInfo

Inherited from​

$Properties.nexusHandlerFailureInfo

nexusOperationExecutionFailureInfo​

• Optional nexusOperationExecutionFailureInfo: null | $Properties

Failure nexusOperationExecutionFailureInfo

Inherited from​

$Properties.nexusOperationExecutionFailureInfo

resetWorkflowFailureInfo​

• Optional resetWorkflowFailureInfo: null | $Properties

Failure resetWorkflowFailureInfo

Inherited from​

$Properties.resetWorkflowFailureInfo

serverFailureInfo​

• Optional serverFailureInfo: null | $Properties

Failure serverFailureInfo

Inherited from​

$Properties.serverFailureInfo

source​

• Optional source: null | string

The source this Failure originated in, e.g. TypeScriptSDK / JavaSDK In some SDKs this is used to rehydrate the stack trace into an exception object.

Inherited from​

$Properties.source

stackTrace​

• Optional stackTrace: null | string

Failure stackTrace

Inherited from​

$Properties.stackTrace

terminatedFailureInfo​

• Optional terminatedFailureInfo: null | $Properties

Failure terminatedFailureInfo

Inherited from​

$Properties.terminatedFailureInfo

timeoutFailureInfo​

• Optional timeoutFailureInfo: null | $Properties

Failure timeoutFailureInfo

Inherited from​

$Properties.timeoutFailureInfo