es-toolkit/docs/reference/promise/delay.md

delay

Delays the execution of code for a specified number of milliseconds.

This function returns a Promise that resolves after the specified delay, allowing you to use it with async/await to pause execution. It also supports an optional AbortSignal to cancel the delay.

Signature

function delay(ms: number, options?: DelayOptions): Promise<void>;

Parameters

• ms (number): The number of milliseconds to delay.
• options (DelayOptions, optional): An options object.
  • signal (AbortSignal, optional): An optional AbortSignal to cancel the delay.

Returns

(Promise<void>): A Promise that resolves after the specified delay.

Examples

Basic Usage

async function foo() {
  console.log('Start');
  await delay(1000); // Delays execution for 1 second
  console.log('End');
}

foo();

Using with an AbortSignal

async function foo() {
  const controller = new AbortController();
  const signal = controller.signal;

  setTimeout(() => controller.abort(), 50); // Will cancel the delay after 50ms
  try {
    await delay(1000, { signal });
  } catch (error) {
    console.log(error); // Will log 'The operation was aborted'
  }
}