Class: Failure

failure.v1.Failure

Represents a Failure.

Properties

activityFailureInfo

• Optional activityFailureInfo: null | $Properties

Failure activityFailureInfo.

---

applicationFailureInfo

• Optional applicationFailureInfo: null | $Properties

Failure applicationFailureInfo.

---

canceledFailureInfo

• Optional canceledFailureInfo: null | $Properties

Failure canceledFailureInfo.

---

cause

• Optional cause: null | $Properties

Failure cause.

---

childWorkflowExecutionFailureInfo

• Optional childWorkflowExecutionFailureInfo: null | $Properties

Failure 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 --)

---

failureInfo

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

Failure failureInfo.

---

message

• message: string

Failure message.

---

nexusHandlerFailureInfo

• Optional nexusHandlerFailureInfo: null | $Properties

Failure nexusHandlerFailureInfo.

---

nexusOperationExecutionFailureInfo

• Optional nexusOperationExecutionFailureInfo: null | $Properties

Failure nexusOperationExecutionFailureInfo.

---

resetWorkflowFailureInfo

• Optional resetWorkflowFailureInfo: null | $Properties

Failure resetWorkflowFailureInfo.

---

serverFailureInfo

• Optional serverFailureInfo: null | $Properties

Failure serverFailureInfo.

---

source

• source: 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.

---

stackTrace

• stackTrace: string

Failure stackTrace.

---

terminatedFailureInfo

• Optional terminatedFailureInfo: null | $Properties

Failure terminatedFailureInfo.

---

timeoutFailureInfo

• Optional timeoutFailureInfo: null | $Properties

Failure timeoutFailureInfo.

Methods

toJSON

▸ toJSON(): Object

Converts this Failure to JSON.

Returns

Object

JSON object

---

create

▸ create(properties?): Failure & $Shape

Creates a new Failure instance using the specified properties.

Parameters

Name	Type	Description
properties?	$Shape	Properties to set

Returns

Failure & $Shape

Failure instance

▸ create(properties?): Failure

Parameters

Name	Type
properties?	$Properties

Returns

Failure

---

decode

▸ decode(reader, length?): Failure & $Shape

Decodes a Failure message from the specified reader or buffer.

Parameters

Name	Type	Description
reader	Uint8Array | Reader	Reader or buffer to decode from
length?	number	Message length if known beforehand

Returns

Failure & $Shape

Failure

Throws

If the payload is not a reader or valid buffer

Throws

If required fields are missing

---

decodeDelimited

▸ decodeDelimited(reader): Failure & $Shape

Decodes a Failure message from the specified reader or buffer, length delimited.

Parameters

Name	Type	Description
reader	Uint8Array | Reader	Reader or buffer to decode from

Returns

Failure & $Shape

Failure

Throws

If the payload is not a reader or valid buffer

Throws

If required fields are missing

---

encode

▸ encode(message, writer?): Writer

Encodes the specified Failure message. Does not implicitly temporal.api.failure.v1.Failure.verify|verify messages.

Parameters

Name	Type	Description
message	$Properties	Failure message or plain object to encode
writer?	Writer	Writer to encode to

Returns

Writer

Writer

---

encodeDelimited

▸ encodeDelimited(message, writer?): Writer

Encodes the specified Failure message, length delimited. Does not implicitly temporal.api.failure.v1.Failure.verify|verify messages.

Parameters

Name	Type	Description
message	$Properties	Failure message or plain object to encode
writer?	Writer	Writer to encode to

Returns

Writer

Writer

---

fromObject

▸ fromObject(object): Failure

Creates a Failure message from a plain object. Also converts values to their respective internal types.

Parameters

Name	Type	Description
object	Object	Plain object

Returns

Failure

Failure

---

toObject

▸ toObject(message, options?): Object

Creates a plain object from a Failure message. Also converts values to other types if specified.

Parameters

Name	Type	Description
message	Failure	Failure
options?	IConversionOptions	Conversion options

Returns

Object

Plain object