Skip to main content

Function: raceWithAbort()

raceWithAbort<T>(operation: Promise<T>, signal: AbortSignal): Promise<T>

Defined in: shared/utils/abortUtils.ts:440

Races a promise against an AbortSignal.

Type Parameters​

T​

T

Resolved value of the underlying operation.

Parameters​

operation​

Promise<T>

Promise to monitor.

signal​

AbortSignal

Abort signal to race against.

Returns​

Promise<T>

The first settled result between the promise and the abort event.

Remarks​

Useful for APIs without native abort support. The returned promise rejects as soon as the signal aborts, allowing callers to adopt a uniform cancellation flow.

Example​

const controller = new AbortController();

const result = await raceWithAbort(
    someNonAbortableOperation(),
    controller.signal
);

Throws​

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error When the signal aborts before the operation settles.