Promise with a timeout

Sometimes you don’t want to wait for a JavaScript promise to resolve if it takes too long, just like this sentence.

The Promise.race is a perfect solution for this. This method returns a promise that fulfills or rejects as soon as one of the promises in an iterable fulfills or rejects, with the value or reason from that promise.

const timeoutPromise = async ({
  timeout = 1000,
}) => {
  let timeoutHandle;

  const error = new Error(failureMessage || `Timeout of ${timeout}ms exceeded`);
  const timeoutPromise = new Promise((resolve, reject) => {
    timeoutHandle = setTimeout(() => reject(error), timeout);

  const result = await Promise.race([promise, timeoutPromise]);


  return result;

const sleep = new Promise((resolve) => setTimeout(resolve, 20));

// This will throw an error
await timeoutPromise({ promise: sleep(), timeout: 10 });

Inspired by

Happy coding! – Found a mistake or a typo? Please submit a PR to my GitHub-repo.

Like this post? Follow @adriaandotcom on X