后端【免费下载链接】bluebird:bird: :zap: Bluebird is a full featured promise library with unmatched performance.项目地址https://gitcode.com/gh_mirrors/bl/bluebird点击查看免费下载本文是 Bluebird 的官方安装指南对应仓库 docs/docs/install.md的深度扩展版本。Bluebird 是一个完整实现 Promises/A 规范的 Promise 库以出色的性能著称仓库 package.json 中描述为 Full featured Promises/A implementation with exceptionally good performance。本文覆盖浏览器script引入、Bower、npm、Browserify/Webpack 打包集成以及 Node.js 环境下的安装、调试开关与平台兼容策略读完即可在任何主流运行环境中正确安装并优化配置 Bluebird。一、概览三条安装路径根据运行环境的不同Bluebird 提供三种安装方式对应仓库 docs/docs/install.md 中的结构运行环境安装方式典型命令浏览器无模块加载器直接下载脚本标签引入下载bluebird.js/bluebird.min.js浏览器依赖管理器Bowerbower install --save bluebirdNode.js / 模块打包工具npmnpm install bluebird安装后 Bluebird 通过Promise与P两个命名空间暴露自身这一行为在后续“浏览器命名空间”一节详述。二、浏览器安装script 标签直引开发版development下载未压缩的开发版文件bluebird.js通过script引入script src//cdn.jsdelivr.net/npm/bluebird3.7.2/js/browser/bluebird.js/script开发版特性开启 warnings警告与 long stack traces长堆栈追踪。这两个特性会显著拖慢性能因此仅用于开发调试阶段不应在生产环境使用。生产版production下载压缩后的生产版文件bluebird.min.jsscript src//cdn.jsdelivr.net/npm/bluebird3.7.2/js/browser/bluebird.min.js/script生产版特性禁用 warnings 与 long stack tracesgzip 后体积约为 17.76KB该数值来自原文档随版本可能变化以实际产物为准。注意上方 URL 中的3.7.2对应当前仓库 package.json 的version字段。实际使用时请将版本号替换为你要安装的 Bluebird 版本。浏览器中的命名空间与 noConflict在无 AMD 加载器的浏览器环境中通过script引入后库会暴露在Promise和P两个命名空间下。如果页面中已存在其他 Promise 实现或你想把全局Promise让还给原生实现可以调用Promise.noConflict()释放Promise命名空间并把 Bluebird 挂到自定义变量上var Bluebird Promise.noConflict();noConflict的实现位于 src/bluebird.js它先记录加载前的全局Promise调用时若全局Promise仍指向 Bluebird 则恢复旧值最后返回 Bluebird 库引用供你自行命名。官方文档 docs/docs/api/promise.noconflict.md 给出典型场景——与其他 Promise 库共存!-- 先加载另一个 promise 库 -- script typetext/javascript src/scripts/other_promise.js/script script typetext/javascript src/scripts/bluebird_debug.js/script script typetext/javascript // 立刻释放 Promise 命名空间 var Bluebird Promise.noConflict(); // 用其他 Promise 库的实例仍占着 Promise 命名空间转换为 Bluebird Promise var promise Bluebird.resolve(new Promise()); /script三、Bower 安装若项目使用 Bower 管理前端依赖$ bower install --save bluebird--save会把 bluebird 写入bower.json的依赖列表方便团队与 CI 环境复现。四、Browserify 与 Webpack 集成通过 npm 安装后即可在打包工具中require$ npm install bluebird开发 / 调试配置Bluebird 在webpack 与 browserify 环境下默认总是判定为 development 环境见 docs/docs/api/promise.config.md会自动开启 long stack traces 与 warnings。因此开发构建可显式声明也可省略var Promise require(bluebird); // 为 webpack / browserify 配置开发/调试模式 Promise.config({ longStackTraces: true, warnings: true // 注意node 下可加 --trace-warnings 查看 warning 的完整堆栈 });生产 / 性能配置生产构建必须显式关闭这两个特性否则会因默认的 development 判定而白白承受性能开销var Promise require(bluebird); // 为 webpack / browserify 配置生产/性能模式 Promise.config({ longStackTraces: false, warnings: false });Promise.config 完整参数Promise.config是安装后最关键的运行时配置入口完整签名来自 docs/docs/api/promise.config.mdPromise.config(Object { warnings: booleanfalse, longStackTraces: booleanfalse, cancellation: booleanfalse, monitoring: booleanfalse, asyncHooks: booleanfalse } options) - Object;虽然默认值都是false但检测到 development 环境时会自动开启 long stack traces 与 warnings。全部参数示例Promise.config({ // 开启 warnings warnings: true, // 开启长堆栈追踪 longStackTraces: true, // 开启取消机制 cancellation: true, // 开启监控 monitoring: true, // 开启 async hooksNode.js 9.6.0 asyncHooks: true, });其中warnings还支持对象形式单独控制“遗忘 return 语句”这一警告其对应环境变量为BLUEBIRD_W_FORGOTTEN_RETURNPromise.config({ // 开启除“遗忘 return 语句”之外的全部警告 warnings: { wForgottenReturn: false } });小结环境判定与性能的关系长堆栈追踪与警告的启用逻辑在 src/debuggability.js 中有源码级体现debugging开关取决于BLUEBIRD_DEBUG环境变量或NODE_ENV developmentwarnings与longStackTraces又分别受BLUEBIRD_WARNINGS、BLUEBIRD_LONG_STACK_TRACES的显式取值覆盖。这解释了为什么生产构建必须显式Promise.config({longStackTraces: false, warnings: false})——否则浏览器打包环境默认的 development 判定会让这两个高开销特性保持开启。五、Node.js 安装基本安装$ npm install bluebirdvar Promise require(bluebird);安装后require(bluebird)返回库入口 js/release/bluebird.jspackage.json的main字段指向该构建产物构建脚本见 package.json。开发环境开启调试特性$ NODE_ENVdevelopment node server.js设置NODE_ENVdevelopment会自动开启 long stack traces 与 warnings。生产环境开启调试特性$ BLUEBIRD_DEBUG1 node server.jsBLUEBIRD_DEBUG会强制开启 long stack traces 与 warnings适合在生产环境临时排查问题。六、环境变量全局开关的底层原理环境变量作用于环境中运行的所有 Bluebird 实例而非仅当前require的那个。完整说明见 docs/docs/api/environment-variables.md且该文档明确环境变量机制仅适用于 node.js 或 io.js。2.x 支持的环境变量BLUEBIRD_DEBUG— 设为任意真值即开启 long stack traces 与 warningsNODE_ENV— 恰好等于development时效果等同设置BLUEBIRD_DEBUG3.x 支持的环境变量当前仓库为 3.7.2环境变量取值与效果BLUEBIRD_DEBUG设为任意真值开启 long stack traces 与 warnings除非被显式禁用设为恰好为0可覆盖NODE_ENVdevelopment带来的自动开启NODE_ENV恰好为development时等同设置BLUEBIRD_DEBUGBLUEBIRD_WARNINGS恰好为0时显式禁用warnings 并覆盖其他所有开启它的设置任意真值显式启用BLUEBIRD_LONG_STACK_TRACES恰好为0时显式禁用long stack traces 并覆盖其他设置任意真值显式启用BLUEBIRD_W_FORGOTTEN_RETURN独立控制“遗忘 return 语句”警告需在 warnings 开启前提下生效这些开关在源码 src/debuggability.js 中被逐一读取warnings由BLUEBIRD_WARNINGS ! 0 (debugging || BLUEBIRD_WARNINGS)决定longStackTraces同理wForgottenReturn则是独立的环境变量。底层读取函数env(key)位于 src/util.js仅当process.env存在时才返回对应值因此在浏览器环境中这些变量自然失效——这正是官方文档声明“仅适用于 node.js/io.js”的原因。组合使用示例# 全部显式开启等效于 BLUEBIRD_DEBUG1 BLUEBIRD_LONG_STACK_TRACES1 BLUEBIRD_WARNINGS1 node app.js # 即使在 development 环境下也显式禁用 warnings NODE_ENVdevelopment BLUEBIRD_WARNINGS0 node app.js注意cancellation取消始终按每个 Bluebird 实例单独配置不通过环境变量控制。七、支持的平台与兼容策略Bluebird 官方支持并在node.js、iojs 以及 IE7 起的浏览器上持续测试非官方平台仅做尽力支持。仓库测试体系位于 test/mocha含 Promise/A 规范测试 2.1.x–2.3.x、API 行为测试等并通过 tools/saucelabs_runner.js 在浏览器矩阵上执行回归验证。IE7 / IE8 的兼容别名IE7 和 IE8不支持把关键字用作属性名因此若必须支持这些浏览器需要使用兼容别名调用以下 API标准方法兼容别名Promise.try()Promise.attempt().catch().caught().finally().lastly().return().thenReturn().throw().thenThrow()这些别名在源码中是同一方法的双重挂载例如Promise.attempt Promise[try]见 src/method.jsPromise.prototype.caught Promise.prototype[catch]见 src/promise.jsPromise.prototype.lastly Promise.prototype[finally]见 src/finally.jsPromise.prototype.thenReturn与Promise.prototype[return]同义、thenThrow与[throw]同义见 src/direct_resolve.js因此在 IE7/IE8 上应写作Promise.attempt(...)、.caught(...)、.lastly(...)、.thenReturn(...)、.thenThrow(...)以避免语法/解析问题在其他现代环境中两套写法可互换。长堆栈追踪的浏览器支持范围Long stack traces 仅受以下浏览器支持Chrome、较新的 Firefox 以及 Internet Explorer 10。在旧 IE 或不支持的浏览器中该特性不会生效相关配置会被忽略。八、安装后的最佳实践清单综合以上内容给出实操建议浏览器直接引入开发用未压缩的bluebird.js带警告与长堆栈生产用bluebird.min.jsgzip 约 17.76KB无调试开销。与既有 Promise 库共存加载后立刻var Bluebird Promise.noConflict()释放全局Promise命名空间参考 docs/docs/api/promise.noconflict.md。Webpack / Browserify开发构建可依赖自动的 development 判定生产构建务必显式Promise.config({ longStackTraces: false, warnings: false })。Node.js开发用NODE_ENVdevelopment生产临时排查用BLUEBIRD_DEBUG1需要细粒度控制时组合使用BLUEBIRD_WARNINGS、BLUEBIRD_LONG_STACK_TRACES、BLUEBIRD_W_FORGOTTEN_RETURN。兼容旧浏览器面向 IE7/IE8 时统一改用attempt、caught、lastly、thenReturn、thenThrow别名。按实例配置cancellation、asyncHooks 等特性按实例通过Promise.config设置不受环境变量影响。以上安装路径、配置项与平台约束均以当前仓库文档docs/docs/install.md、docs/docs/api/promise.config.md、docs/docs/api/environment-variables.md与源码实现为准版本号为仓库 package.json 中声明的 3.7.2。赞分享后端【免费下载链接】bluebird:bird: :zap: Bluebird is a full featured promise library with unmatched performance.项目地址https://gitcode.com/gh_mirrors/bl/bluebird点击查看免费下载相关推荐Oak语言语法详解Rust风格的简洁语法与强大编译时标志Oak语言语法详解Rust风格的简洁语法与强大编译时标志 Oak语言是一种具有紧凑中间表示的可移植编程语言它结合了Rust风格的简洁语法与强大的编译时标志功后端vue-idle-game核心玩法解析如何高效刷取顶级装备vue idle game核心玩法解析如何高效刷取顶级装备 vue idle game是一款全随机的刷装备小游戏玩家可以在游戏中通过探索地图、挑战副本和强化前端游戏开发Camoufox反检测浏览器安装与配置完全指南Camoufox反检测浏览器安装与配置完全指南 项目概述与核心价值 Camoufox是一款开源的反检测浏览器专门为网络爬虫和数据采集开发者设计。它通过先进的指网页爬虫浏览器控制上一篇aws-sdk-java-v2 2.48.x 版本发布全解析CRT 客户端 TLS 策略、S3 预签名下载与认证链路修复下一篇DaoCloud 公开镜像加速终极完整指南10倍提升容器镜像下载速度 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考