Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

bluebird3

overlookmotel18MIT3.1.3

bluebird v3.x

bluebird

readme

bluebird3.js

bluebird v3.x

Current status

NPM version Build Status Dependency Status Dev dependency Status Coverage Status

Usage

Exports bluebird Promise library v3.x.

Why on earth would you use this rather than bluebird itself? Well you probably wouldn't, and shouldn't.

Only reason is along with bluebird2 if you need to load both versions v2.x and v3.x of bluebird simultaneously, for example for running tests on a module which should work with either version.

var Bluebird2 = require('bluebird2');
var Bluebird3 = require('bluebird3');
// Now you have both. Whoopee!

Bluebird.getNewLibraryCopy()

This module adds one method to the Bluebird constructor if not present already: .getNewLibraryCopy()

.getNewLibraryCopy() returns a new independent instance of the Bluebird constructor.

var Bluebird = require('bluebird3');
var BluebirdX = Bluebird.getNewLibraryCopy();

console.log(BluebirdX != Bluebird); // true

Bluebird.version

The module adds .version property to the Bluebird constructor, containing the semver version of Bluebird.

var Bluebird = require('bluebird3');
console.log(Bluebird.version); // e.g. '3.3.5'

Tests

Use npm test to run the tests. Use npm run cover to check coverage.

Changelog

See changelog.md

Issues

If you discover a bug, please raise an issue on Github. https://github.com/overlookmotel/bluebird3/issues

Contribution

Pull requests are very welcome. Please:

  • ensure all tests pass before submitting PR
  • add an entry to changelog
  • add tests for new features
  • document new functionality/API additions in README

changelog

Changelog

1.0.0

  • Initial release

1.1.0

  • Update bluebird dependency to v3.3.5
  • clone method

1.1.1

  • Update changelog

1.2.0

  • version property

2.0.0

  • Return independent instance of bluebird
  • Update bluebird to v3.4.0
  • Update dev dependencies
  • Replace Makefile with npm scripts
  • Travis tests against node v6

2.1.0

  • .getNewLibraryCopy() method (was .clone())
  • Update bluebird to v3.4.1

3.0.0

  • Remove .clone() method
  • Pin bluebird dependency to trigger a PR from greenkeeper whenever new version released
  • Travis CI runs on all branches (to allow greenkeeper to trigger Travis)
  • Travis CI does not run on tags
  • Tidy npm scripts
  • Update dev dependencies

3.0.1

  • Fix coveralls npm script

3.0.2

  • Update bluebird to v3.4.2

3.0.3

  • Update bluebird to v3.4.3

3.0.4

  • Update bluebird to v3.4.4

3.0.5

  • Update bluebird to v3.4.5

3.0.6

  • Update bluebird to v3.4.6

3.0.7

  • Update bluebird to v3.4.7
  • Update dev dependencies
  • Travis CI test against node v7

3.1.0

  • Update bluebird to v3.5.0

3.1.1

  • Update bluebird to v3.5.1
  • Update dev dependencies
  • Fix: Remove Makefile
  • Fix: .gitignore correct case of .DS_Store
  • Travis run tests on Node versions 4, 6, 8, 9

3.1.2

  • Update bluebird to v3.5.2
  • Update dev dependencies
  • Travis run tests on Node versions 6, 8, 10

3.1.3

  • Update bluebird to v3.5.4