Skip to main content

Function: sleep()

sleep(ms: number, signal?: AbortSignal): Promise<void>

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

Promise-based sleep helper with AbortSignal support.

Parametersโ€‹

msโ€‹

number

Delay duration in milliseconds.

signal?โ€‹

AbortSignal

Optional cancellation signal to observe.

Returnsโ€‹

Promise<void>

Promise that resolves after the requested delay.

Remarksโ€‹

Negative, zero, or non-finite durations resolve immediately. When the signal aborts during the delay window, the returned promise rejects with a new https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error describing the cancellation.

Exampleโ€‹

import { logger } from "@app/services/logger";

const controller = new AbortController();

try {
await sleep(5_000, controller.signal);
logger.info("Delay completed");
} catch (error) {
if (isAbortError(error)) {
logger.warn("Delay was aborted");
}
}

Throwsโ€‹

When the supplied signal aborts before the delay completes.