Skip to main content

Class: AsyncCompletionClient

client.AsyncCompletionClient

A client for asynchronous completion and heartbeating of Activities.

Typically this client should not be instantiated directly, instead create the high level Client and use Client.activity to complete async activities.

Hierarchy​

Constructors​

constructor​

• new AsyncCompletionClient(options?): AsyncCompletionClient

Parameters​

NameType
options?BaseClientOptions

Returns​

AsyncCompletionClient

Overrides​

BaseClient.constructor

Properties​

connection​

• Readonly connection: ConnectionLike

The underlying connection or NativeConnection | native connection used by this client.

Clients are cheap to create, but connections are expensive. Where it makes sense, a single connection may and should be reused by multiple Clients.

Inherited from​

BaseClient.connection


options​

• Readonly options: LoadedAsyncCompletionClientOptions

Accessors​

workflowService​

• get workflowService(): WorkflowService

Raw gRPC access to the Temporal service.

NOTE: The namespace provided in options is not automatically set on requests made via this service object.

Returns​

WorkflowService

Methods​

complete​

▸ complete(taskToken, result, options?): Promise<void>

Complete an Activity by task token

Parameters​

NameType
taskTokenUint8Array
resultunknown
options?AsyncCompletionCompleteOptions & AsyncCompletionOperationOptions

Returns​

Promise<void>

▸ complete(fullActivityId, result, options?): Promise<void>

Complete an Activity by full ID

Parameters​

NameType
fullActivityIdFullActivityId
resultunknown
options?AsyncCompletionCompleteOptions

Returns​

Promise<void>


fail​

▸ fail(taskToken, err, options?): Promise<void>

Fail an Activity by task token

Parameters​

NameType
taskTokenUint8Array
errunknown
options?AsyncCompletionOperationOptions

Returns​

Promise<void>

▸ fail(fullActivityId, err): Promise<void>

Fail an Activity by full ID

Parameters​

NameType
fullActivityIdFullActivityId
errunknown

Returns​

Promise<void>


heartbeat​

▸ heartbeat(taskToken, details?, options?): Promise<void>

Send Activity heartbeat by task token

Parameters​

NameType
taskTokenUint8Array
details?unknown
options?AsyncCompletionOperationOptions

Returns​

Promise<void>

▸ heartbeat(fullActivityId, details?): Promise<void>

Send Activity heartbeat by full ID

Parameters​

NameType
fullActivityIdFullActivityId
details?unknown

Returns​

Promise<void>


reportCancellation​

▸ reportCancellation(taskToken, details?, options?): Promise<void>

Report Activity cancellation by task token

Parameters​

NameType
taskTokenUint8Array
details?unknown
options?AsyncCompletionOperationOptions

Returns​

Promise<void>

▸ reportCancellation(fullActivityId, details?): Promise<void>

Report Activity cancellation by full ID

Parameters​

NameType
fullActivityIdFullActivityId
details?unknown

Returns​

Promise<void>


withAbortSignal​

▸ withAbortSignal<R>(abortSignal, fn): Promise<R>

Set an AbortSignal that, when aborted, cancels any ongoing service requests executed in fn's scope. This will locally result in the request call throwing a _grpc.ServiceError|ServiceError with code _grpc.status.CANCELLED|CANCELLED; see isGrpcCancelledError.

This method is only a convenience wrapper around Connection.withAbortSignal.

Type parameters​

Name
R

Parameters​

NameType
abortSignalAbortSignal
fn() => Promise<R>

Returns​

Promise<R>

value returned from fn

See

https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal

Inherited from​

BaseClient.withAbortSignal


withDeadline​

▸ withDeadline<R>(deadline, fn): Promise<R>

Set a deadline for any service requests executed in fn's scope.

The deadline is a point in time after which any pending gRPC request will be considered as failed; this will locally result in the request call throwing a _grpc.ServiceError|ServiceError with code _grpc.status.DEADLINE_EXCEEDED|DEADLINE_EXCEEDED; see isGrpcDeadlineError.

It is stronly recommended to explicitly set deadlines. If no deadline is set, then it is possible for the client to end up waiting forever for a response.

This method is only a convenience wrapper around Connection.withDeadline.

Type parameters​

Name
R

Parameters​

NameTypeDescription
deadlinenumber | Datea point in time after which the request will be considered as failed; either a Date object, or a number of milliseconds since the Unix epoch (UTC).
fn() => Promise<R>-

Returns​

Promise<R>

the value returned from fn

See

https://grpc.io/docs/guides/deadlines/

Inherited from​

BaseClient.withDeadline


withMetadata​

▸ withMetadata<R>(metadata, fn): Promise<R>

Set metadata for any service requests executed in fn's scope.

This method is only a convenience wrapper around Connection.withMetadata.

Type parameters​

Name
R

Parameters​

NameType
metadataMetadata
fn() => Promise<R>

Returns​

Promise<R>

returned value of fn

Inherited from​

BaseClient.withMetadata