# bluebird-global

> Patches global.Promise to use bluebird and returns a bluebird instance

Latest version **1.0.1** (published 2017-08-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install bluebird-global
pnpm add bluebird-global
yarn add bluebird-global
bun add bluebird-global
```

## Health

**Score 18/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2017-08-21 |
| First published | 2017-08-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/bluebird-global) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | kaatt |
| Maintainers | kaatt |
| Keywords | polyfill, promise-library, promise, performance, promises, promises-a, promises-aplus, async, await |

## Links

- npm: https://www.npmjs.com/package/bluebird-global
- Repository: https://github.com/kaatt/bluebird-global
- Homepage: https://github.com/kaatt/bluebird-global#readme
- Issues: https://github.com/kaatt/bluebird-global/issues
- npm.io page: https://npm.io/package/bluebird-global

## Alternatives

- [@commercetools/sync-actions](https://npm.io/package/@commercetools/sync-actions.md) — 25.1K weekly downloads
- [cwait](https://npm.io/package/cwait.md) — 21.4K weekly downloads
- [@ledgerhq/hw-app-cosmos](https://npm.io/package/@ledgerhq/hw-app-cosmos.md) — 4.2K weekly downloads
- [@financial-times/o-loading](https://npm.io/package/@financial-times/o-loading.md) — 2.8K weekly downloads
- [fa](https://npm.io/package/fa.md) — 185 weekly downloads

## Recent versions

- 1.0.1 (latest) — 2017-08-21

## README

# bluebird-global

Micromodule. Patches `global.Promise` to use the [bluebird library][bluebird-lib] which has [better than native performance for Promises][bluebird-is-faster].

Simply install any version of `bluebird` that you wish the library to use (`bluebird` is a peer dependency) and call:

```js
import bluebird from 'bluebird-global'
```

or

```js
const bluebird = require('bluebird-global')
```

All extra functions that bluebird provides but isn't defined in the ES spec should called like `bluebird.map` instead of like `Promise.map` so that TypeScript and Flow don't complain.

You can simply call `import 'bluebird-global'` or `require('bluebird-global')` if you won't use any bluebird-specific functions.

[bluebird-lib]: https://www.npmjs.com/package/bluebird
[bluebird-is-faster]: https://softwareengineering.stackexchange.com/questions/278778/why-are-native-es6-promises-slower-and-more-memory-intensive-than-bluebird

## License

MIT © [kaatt](https://github.com/kaatt)

---
_Source: https://npm.io/package/bluebird-global · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
