vue-reactive-stateful-promise

Native Promise wrapper with reactive state getters (isPending, isResolved, isRejected).

Installation

npm install vue-reactive-stateful-promise

Usage

1import StatefulPromise from 'vue-reactive-stateful-promise';

Constructor

Create a new promise the same way as you would with the Promise constructor:

1
2  let p = new StatefulPromise((res, rej) => {
3    // ...
4  });
5
6  p.isPending; // true
7  p.isResolved; // false
8  p.isRejected; // false

Pass in an async function:

1
2  let p = new StatefulPromise(async () => {
3    // ...
4  });
5
6  p.isPending; // true
7  p.isResolved; // false
8  p.isRejected; // false

Extend an existing promise:

1  let pr = new Promise((resolve, reject) => {
2    setTimeout(resolve, 10);
3  });
4
5  let p = new StatefulPromise(pr);
6
7  p.isPending; // true
8  p.isResolved; // false
9  p.isRejected; // false

Also works with Promise static methods:

1  let p = StatefulPromise.resolve('foo');
2
3  p.isPending; // false
4  p.isResolved; // true
5  p.isRejected; // false

Options

The constructor also accept options

1  let p = new StatefulPromise((res, rej) => {
2    setTimeout(res, 2000);
3  }, {timeout: 1000, ignoreAbort: true});
4  
5  p.abort(); // This will do nothing
6  
7  p.catch((e) => {
8    console.error(e); // Will return Error: Promise timed out
9  });

License

This software is released under the terms of the GPL 3.0 license. See LICENSE.