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

  • BaseClient

    AsyncCompletionClient

Constructors

constructor

new AsyncCompletionClient(options?): AsyncCompletionClient

Parameters

NameType
options?BaseClientOptions

Returns

AsyncCompletionClient

Overrides

BaseClient.constructor

Properties

connection

Readonly connection: ConnectionLike

The underlying connection used by this client.

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

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): Promise<void>

Complete an Activity by task token

Parameters

NameType
taskTokenUint8Array
resultunknown

Returns

Promise<void>

complete(fullActivityId, result): Promise<void>

Complete an Activity by full ID

Parameters

NameType
fullActivityIdFullActivityId
resultunknown

Returns

Promise<void>


fail

fail(taskToken, err): Promise<void>

Fail an Activity by task token

Parameters

NameType
taskTokenUint8Array
errunknown

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?): Promise<void>

Send Activity heartbeat by task token

Parameters

NameType
taskTokenUint8Array
details?unknown

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?): Promise<void>

Report Activity cancellation by task token

Parameters

NameType
taskTokenUint8Array
details?unknown

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