For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reference/promise/delay.md.
Install massaman

    delay es-toolkit

    Delays code execution for a specified amount of time.

    await delay(ms, options?);

    Usage

    delay(ms, options?)

    Use delay when you want to pause code execution for a specific amount of time. You can use it with async/await to make the next code execute after a certain time. If needed, you can also cancel the delay through an AbortSignal.

    import { delay } from 'es-toolkit/promise';

async function example() {
  console.log('Start');
  await delay(1000); // Delays execution for 1 second
  console.log('Executed after 1 second');

  await delay(500); // Delays for an additional 0.5 seconds
  console.log('Executed after an additional 0.5 seconds');
}

example();

    You can also cancel the delay using AbortSignal:

    async function cancellableDelay() {
  const controller = new AbortController();
  const { signal } = controller;

  // Cancel the delay after 50ms
  setTimeout(() => controller.abort(), 50);

  try {
    await delay(1000, { signal });
    console.log('1 second has passed'); // This code won't execute
  } catch (error) {
    console.log('Delay was cancelled'); // AbortError is thrown
  }
}

    It's also useful for simulating asynchronous behavior in tests.

    async function simulateNetworkRequest() {
  console.log('Starting network request...');
  await delay(2000); // Simulates a 2-second network delay
  console.log('Response received!');
  return { data: 'test' };
}

    Parameters

    msnumberrequired

    The amount of time to delay in milliseconds.

    optionsDelayOptionsoptional

    Delay options.

    • signal (AbortSignal, optional): An AbortSignal to cancel the delay.

    Returns

    Returns a Promise that completes after the specified time.

    Promise<void>

    Errors

    Throws AbortError when the AbortSignal is activated.

    Source: es-toolkit

    Re-exported verbatim from es-toolkit. Implementation, edge cases, and performance behavior are owned upstream. This page mirrors the documentation at the pinned version; the linked source is authoritative.