doodlewind / nativebird

🐦 Bluebird alternative within ~200 loc

NativeBird

Ultralight promise extension compatible with Bluebird

Introduction

中文介绍

As a pioneer in JavaScript async ecosystem, Bluebird is a great userland promise library with handy utility methods included. However the way it works leads to larger bundle size and more verbose stack trace.

NativeBird is compatible with a core Bluebird subset by extending native promise, and all of its extended APIs (implemented within ~200 lines) are fully tested with the corresponding test cases in Bluebird.

NativeBird can be used in several scenarios:

• To reuse promise utility methods like Promise.map and Promise.each without copying snippets from a gist.
• To perform migration in existing Bluebird projects.
• To simply learn JavaScript async operation skills 🐶.

Installation

npm install nativebird

import Promise from "nativebird";

It's also fine to copy promise.mjs and its type definition directly into your project directory.

API

• Static methods:
  • Promise.delay
  • Promise.try
  • Promise.each
  • Promise.mapSeries
  • Promise.map
  • Promise.reduce
  • Promise.defer (deprecated)
• Instance methods:
  • promise.delay
  • promise.map
  • promise.reduce
  • promise.mapSeries
  • promise.each
  • promise.timeout
  • promise.tap
  • promise.all
  • promise.spread

Since NativeBird inherits from native promise, all promise APIs defined in ECMAScript standard (say Promise.allSettled and Promise.any) are naturally supported.

Caveats

• Promise.cancel is not supported.
• Synchronous inspection (e.g. Promise.isFulfilled) is not supported.

Contribution

To implement a new API in Bluebird, please also port the corresponding test cases under test/mocha in Bluebird repo and test it with npm test.

License

MIT

nativebird's Issues

Add a cjs version?

Though esm is the future of JavaScript, there are still many projects using cjs. If we can use nativebird in cjs (such as hexo - to drop bluebird) it would be fantastic.

If you like I can send a pr.

Promise.mapSeries 异常不会被 catch 捕获

Promise.mapSeries([0, 1, 2], (v) => {
    if (v > 0) throw new Error('111');
    return v;
}).catch(() => {
    // 没触发
    debugger;
});

Tree shaking support

Not sure if this is required for the ~200 LOC size, but can be useful if we want it to scale.