Skip to content
Docs Try Aspire

AspireClient

Handle
📦 Aspire.Hosting v13.2.0-preview.1.26159.1
interface AspireClient {
readonly connected: boolean;
cancelToken(tokenId: string): Promise<boolean>;
connect(timeoutMs?: number): Promise<void>;
disconnect(): void;
invokeCapability(
capabilityId: string,
args?: Record<string, unknown>): Promise<T>;
onDisconnect(callback: () => void): void;
ping(): Promise<string>;
}

Properties

property connected boolean get
Whether the client is currently connected

Methods

method cancelToken
Cancel a CancellationToken by its ID
cancelToken(tokenId: string): Promise<boolean>
tokenId string
Promise<boolean>
method connect
Connect to the AppHost
connect(timeoutMs?: number): Promise<void>
timeoutMs number optional
Promise<void>
method disconnect
Disconnect from the AppHost
disconnect(): void
Invoke an ATS capability by ID. Results are automatically wrapped in Handle objects when applicable.
invokeCapability<T>(
capabilityId: string,
args?: Record<string, unknown>): Promise<T>
capabilityId string
args Record<string, unknown> optional
Promise<T>
method onDisconnect
Register a callback for connection loss
onDisconnect(callback: () => void): void
callback () => void
method ping
Send a ping to verify the connection
ping(): Promise<string>
Promise<string>