Установка

• Установка в браузере
• Установка в Node.js
• Поддерживаемые платформы

Установка в браузере

Загрузить bluebird 3.7.2 (разработка)

Исходный файл без минимизации, предназначенный для использования в режиме разработки. Включены предупреждения и длинные трассировки стека, которые оказывают нагрузку на производительность.

<script src="//cdn.jsdelivr.net/npm/bluebird@3.7.2/js/browser/bluebird.js"></script>

Загрузить bluebird 3.7.2 (производство)

Минифицированный исходный файл, предназначенный для использования в режиме производства. Предупреждения и длинные трассировки стека отключены. Сжатый размер составляет 17.76 КБ.

<script src="//cdn.jsdelivr.net/npm/bluebird@3.7.2/js/browser/bluebird.min.js"></script>

Если не установлен загрузчик AMD, установка с помощью тега script экспортирует библиотеку в пространства имен Promise и P. Если необходимо восстановить пространство имен Promise, используйте var Bluebird = Promise.noConflict().

Bower

$ bower install --save bluebird

Browserify и Webpack

$ npm install bluebird

Использование webpack для разработки/отладки:

var Promise = require("bluebird");
// Configure webpack and browserify for development/debugging
Promise.config({
    longStackTraces: true,
    warnings: true // note, run node with --trace-warnings to see full stack traces for warnings
})

Использование webpack для производства/производительности:

var Promise = require("bluebird");
// Configure webpack and browserify for production/performance
Promise.config({
    longStackTraces: false,
    warnings: false
})

Установка в Node.js

$ npm install bluebird

var Promise = require("bluebird");

Для включения длинных трассировок стека и предупреждений в режиме разработки Node.js:

$ NODE_ENV=development node server.js

Для включения длинных трассировок стека и предупреждений в режиме производства Node.js:

$ BLUEBIRD_DEBUG=1 node server.js

См. Environment Variables.

Поддерживаемые платформы

Библиотека Bluebird официально поддерживает и тестируется в node.js, iojs и браузерах начиная с IE7. Неофициальные платформы поддерживаются с лучшим возможным результатом.

IE7 и IE8 не поддерживают использование ключевых слов в качестве имён свойств, поэтому если требуется поддержка этих браузеров, необходимо использовать совместимые алиасы:

• Promise.try() -> Promise.attempt()
• .catch() -> .caught()
• .finally() -> .lastly()
• .return() -> .thenReturn()
• .throw() -> .thenThrow()

Длинные трассировки стека поддерживаются только в Chrome, последних версиях Firefox и Internet Explorer 10 и выше.