promise-timeout

promise-timeout

A super-simple way to put a timeout on promise resolution.

It assumes you already have either platform support for promises (Node 0.12 or greater), or you have a polyfill (see es6-promise).

Installation

$ npm install promise-timeout

Usage

timeout(promise, timeoutMillis)

Rejects a promise with a TimeoutError if it does not settle within the specified timeout. Parameters:

• promise: Promise - Promise to monitor.
• timeoutMillis: number - Number of milliseconds to wait on settling.

TimeoutError

Exception indicating that the timeout expired.

Examples

ES2015:

import { timeout, TimeoutError } from 'promise-timeout';

let somePromise = goDoSomething();

timeout(somePromise, 1000)
  .then((thing) => console.log('I did a thing!'))
  .catch((err) => {
    if (err instanceof TimeoutError) {
      console.error('Timeout :-(');
    }
  });

ES5:

'use strict';

var pt = require('promise-timeout');

var somePromise = goDoSomething();

pt.timeout(somePromise, 1000)
  .then(function (thing) {
    console.log('I did a thing!');
  }).catch(function (err) {
    if (err instanceof pt.TimeoutError) {
      console.error('Timeout :-(');
    }
  });

Similar packages

Other packages similar to promise-timeout

p-timeout

The `p-timeout` package provides similar functionality to `promise-timeout` by allowing you to set a timeout on a promise. It also offers additional features such as custom error messages and fallback values. Compared to `promise-timeout`, `p-timeout` has a more extensive API and better integration with other promise-based utilities.

promise-time

The `promise-time` package offers timeout functionality for promises, similar to `promise-timeout`. It allows you to specify a timeout duration and will reject the promise if it does not resolve within that time. `promise-time` is simpler and more lightweight compared to `promise-timeout`, making it a good choice for projects with minimal dependencies.