后端【免費下載鏈接】bluebird:bird: :zap: Bluebird is a full featured promise library with unmatched performance.項目地址https://gitcode.com/gh_mirrors/bl/bluebird點擊查看免費下載Bluebird 是一款以完整功能與高性能著稱的 Promise 庫。在使用過程中開發(fā)者常會遇到一系列以Error:開頭的明確報錯——這些錯誤信息并非雜亂無章的運行時異常而是庫對誤用場景精心設計的引導式提示。本文以 Bluebird 官方文檔《Error Explanations》為主線逐一剖析 17 個常見錯誤的觸發(fā)場景、修復方法并結合當前倉庫源碼src/目錄揭示每個錯誤背后的真實拋出點與校驗邏輯。讀完本文你將能快速定位自己代碼中的問題并理解 Bluebird 在構造器校驗、promisification、協(xié)程、集合操作、同步檢查等關鍵機制上的設計意圖。1. Error: Promise.promisify called on an object觸發(fā)場景把整個對象而不是單個函數(shù)傳給了Promise.promisify例如var fs Promise.promisify(require(fs));原因分析Promise.promisify的設計目標是包裝單個回調風格函數(shù)而不是一整個模塊或對象。從 src/promisify.js 可以看到Promise.promisify入口首先校驗參數(shù)類型Promise.promisify function (fn, options) { if (typeof fn ! function) { throw new TypeError(FUNCTION_ERROR util.classString(fn)); } ... };傳入require(fs)這樣的對象時typeof fn ! function成立于是拋出類型錯誤。修復方案改用Promise.promisifyAll它會遍歷對象含繼承的屬性上的方法為每個方法生成帶Async后綴的 promisified 版本var fs Promise.promisifyAll(require(fs)); // 之后即可使用 fs.readFileAsync(...) 等詳細用法見 Promise.promisifyAll 與 promisification 專題。2. Error: the promise constructor requires a resolver function觸發(fā)場景使用new Promise()或new Promise(something)時沒有傳入函數(shù)作為參數(shù)。原因分析在 src/promise.js 中構造函數(shù)會調用check()進行雙重校驗function check(self, executor) { if (self null || self.constructor ! Promise) { throw new TypeError(CONSTRUCT_ERROR_INVOCATION); } if (typeof executor ! function) { throw new TypeError(FUNCTION_ERROR util.classString(executor)); } }第二個if正是本錯誤的拋出點——executorresolver必須是一個函數(shù)。正確寫法手動包裝一個異步 API 時resolver 函數(shù)接收resolve和reject兩個參數(shù)function wrapWithPromise(parameter) { return new Promise(function (resolve, reject) { doSomethingAsync({ error: reject, success: resolve }); }); }更推薦的做法與其手寫包裝不如直接使用自動 promisificationPromise.promisify/Promise.promisifyAll或 Promise.method 把普通函數(shù)轉成返回 Promise 的函數(shù)。相關基礎可閱讀 new Promise。3. Error: the promise constructor cannot be invoked directly這個錯誤可能由兩類原因導致需要分別排查。3.1 忘記使用new關鍵字觸發(fā)場景直接以函數(shù)調用方式創(chuàng)建 Promisereturn Promise(function(resolve, reject) { // ... });原因分析回到check()的第一條校驗self null || self.constructor ! Promise。直接調用Promise(...)時this不再是Promise的實例在嚴格模式下甚至是undefined于是拋出CONSTRUCT_ERROR_INVOCATION錯誤信息定義于 src/constants.js。修復方案補上newreturn new Promise(function(resolve, reject) { // ... });同樣地也可以考慮自動 promisification 或 Promise.method 來省去手寫構造器。3.2 試圖繼承/子類化 PromiseBluebird不支持通過class X extends Promise {}或Promise.call(this, ...)的方式擴展 Promise。文檔明確指出如需擴展請改用**作用域原型scoped prototypes**機制詳見 features 文檔中的 Scoped Prototypes 一節(jié)。4. Error: expecting an array, a promise or a thenable觸發(fā)場景某個期望接收 Promise或集合的函數(shù)收到了其他類型的值。典型有兩大原因。4.1 集合操作卻傳入了單個元素以.map()為例它期望接收一個數(shù)組或數(shù)組的 Promise而不是單個值function returnThree(){ return 3; } Promise.resolve(5).map(returnThree).then(function(val){ console.log(Hello Value!, val); });這里Promise.resolve(5)產生的是數(shù)字5而不是數(shù)組map無法對其進行迭代。修正方法是把單個元素放進數(shù)組function returnThree(){ return 3; } Promise.resolve([5]).map(returnThree).then(function(val){ console.log(Hello Value!, val); });把5換成[5]后語句可以運行盡管單獨包一層數(shù)組在實踐中屬于不佳用法更合理的做法是直接用Promise.map([5], fn)。該錯誤的底層文案定義于 src/constants.jsCOLLECTION_ERRORexpecting an array or an iterable object but got ...在 src/promise_array.js 對集合類輸入進行解析時觸發(fā)。4.2 箭頭函數(shù)/匿名函數(shù)中漏寫了return當你在調試或對變量做一次性處理時很容易在匿名函數(shù)里忘掉return導致 Promise 鏈斷裂function nextFunction(something){ return Promise.resolve(something*3); } myFunction().then(result { console.log(Debug:, result); nextFunction(result)); // 鏈斷掉了這里沒有向 .then() 返回任何東西 });因為這是一個匿名函數(shù)調用必須顯式return出符合 Promise 語義的值function nextFunction(something){ return Promise.resolve(something*3); } myFunction().then(result { console.log(Debug:, result); return nextFunction(result)); // 匿名函數(shù)返回調用結果.then() 才能拿到 Promise });漏寫return時.then()回調實際返回undefinedBluebird 無法將其轉換為 Promise從而在后續(xù)鏈上報出本類錯誤。5. Error: generatorFunction must be a function觸發(fā)場景調用 Promise.coroutine 時沒有傳入生成器函數(shù)注意函數(shù)名后的*Promise.coroutine(function* () { // 注意這個 * var data yield $.get(http://www.example.com); var moreUrls data.split(\n); var contents []; for( var i 0, len moreUrls.length; i len; i ) { contents.push(yield $.get(moreUrls[i])); } return contents; });原因分析在 src/generators.js 中Promise.coroutine同步拋出該錯誤注釋說明coroutine 語義上是在編譯期標注靜態(tài)函數(shù)因此同步拋錯而非返回 rejected promisePromise.coroutine function (generatorFunction, options) { if (typeof generatorFunction ! function) { throw new TypeError(NOT_GENERATOR_ERROR); } ... };重要兼容性提示Bluebird 曾急切地檢查生成器這會給使用轉譯器transpiler如 Babel 早期版本的項目帶來問題。因此現(xiàn)在如果你傳入的是普通函數(shù)而不是生成器函數(shù)可能會看到類似TypeError: Cannot read property next of undefined的報錯而不是這里的友好提示。設計意圖Promise.coroutine正是為了讓生成器形成類似 C#async/await的寫法而設計的使用說明見 Generators。6. Error: fn must be a function觸發(fā)場景把非函數(shù)值傳給了期望接收函數(shù)的位置。原因分析該錯誤對應 src/constants.js 中的FUNCTION_ERRORexpecting a function but got ...在 Bluebird 眾多 API 的參數(shù)校驗中廣泛復用。例如Promise.promisify見上文第 1 節(jié)、Promise.coroutine.addYieldHandlersrc/generators.js、Promise.setSchedulersrc/promise.js等入口都會先校驗typeof fn function不滿足即拋出本錯誤。修復思路檢查調用處傳入的是否為函數(shù)引用不要誤寫成fn()調用后的返回值并確認沒有把null/undefined/ 對象等誤傳入。7. Error: cannot enable long stack traces after promises have been created觸發(fā)場景在 Promise 已經創(chuàng)建之后才開啟長堆棧追蹤long stack traces功能。原因分析開啟長堆棧會替換 Promise 原型上的_captureStackTrace等內部方法因此必須在任何 Promise 創(chuàng)建之前完成。在 src/debuggability.js 中可以看到顯式的保護邏輯Promise.longStackTraces function () { if (async.haveItemsQueued() !config.longStackTraces) { throw new Error(LONG_STACK_TRACES_ERROR); } ... };當異步隊列中已有待處理任務意味著已有 Promise 參與調度時再開啟就會同步拋出LONG_STACK_TRACES_ERROR定義于 src/constants.js。修復方案使用longStackTraces時務必把它放在 require Bluebird 之后的第一行代碼Promise.config({ longStackTraces: true });詳細的 API 說明見 Promise.longStackTraces。另外Bluebird 也支持通過環(huán)境變量BLUEBIRD_LONG_STACK_TRACES在加載時啟用見 src/debuggability.js。8. Error: cannot get fulfillment value of a non-fulfilled promise觸發(fā)場景對尚未 settle既未 fulfilled 也未 rejected的 Promise 調用.value()獲取履行值。文檔中的例子var p Promise.delay(1000); p.inspect().value();p在 1 秒后才完成inspect().value()立即調用必然失敗。原因分析在 src/synchronous_inspection.js 中PromiseInspection.prototype.value的實現(xiàn)是var value PromiseInspection.prototype.value function () { if (!this.isFulfilled()) { throw new TypeError(INSPECTION_VALUE_ERROR); } return this._settledValue(); };INSPECTION_VALUE_ERROR定義于 src/constants.js。修復方案先用 .isPending()、.isFulfilled()、.isRejected() 檢查 Promise 狀態(tài)再決定是否讀取值。完整的同步檢查機制見 synchronous inspection。9. Error: cannot get rejection reason of a non-rejected promise觸發(fā)場景與上一節(jié)類似——對尚未 settle 或已經 fulfilled 的 Promise 調用.error()/.reason()獲取拒絕原因var p Promise.delay(1000); p.inspect().value();原因分析在 src/synchronous_inspection.js 中error與reason是同一個方法的別名var reason PromiseInspection.prototype.error PromiseInspection.prototype.reason function () { if (!this.isRejected()) { throw new TypeError(INSPECTION_REASON_ERROR); } return this._settledValue(); };INSPECTION_REASON_ERROR定義于 src/constants.js。修復方案同樣建議先通過 .isPending()、.isFulfilled()、.isRejected() 判斷狀態(tài)再讀取原因同步檢查的完整介紹見 synchronous inspection。10. Error: the target of promisifyAll must be an object or a function觸發(fā)場景把Promise.promisifyAll用在錯誤的值上常見的是傳了函數(shù)調用結果而不是函數(shù)本身或者傳入了null/undefined/ 原始值。原因分析在 src/promisify.js 中Promise.promisifyAll function (target, options) { if (typeof target ! function typeof target ! object) { throw new TypeError(PROMISIFY_TYPE_ERROR); } ... };PROMISIFY_TYPE_ERROR定義于 src/constants.js。正確用法Promise.promisifyAll的標準用法是傳入模塊或對象var fs Promise.promisifyAll(require(fs));更多說明見 promisification 專題。11. Error: circular promise resolution chain觸發(fā)場景一個 Promise 用自身去 resolve/reject 自己形成循環(huán)解析鏈。文檔示例var p Promise.delay(100).then(function(){ return p; });這里p的完成值又指向p自己等價于它做完之時就是它完成之時是語義上的死循環(huán)。原因分析在 src/promise.js 中庫專門封裝了自解析錯誤的構造函數(shù)var makeSelfResolutionError function () { return new TypeError(CIRCULAR_RESOLUTION_ERROR); };CIRCULAR_RESOLUTION_ERROR定義于 src/constants.js。當tryConvertToPromise或內部解析邏輯檢測到用自己解析自己時會拋出該錯誤。深層場景與建議這個錯誤也常出現(xiàn)在實現(xiàn)實時更新模型live-updating model時——例如給模型掛一個表示ready狀態(tài)的.then方法。但Promise 是過程有始有終它并不旨在直接解決這種持續(xù)更新的問題。一個可行的替代方案是使用中間 Promise比如在模型上設置一個.loaded屬性用一個不攜帶任何完成值的 Promise 來表示就緒狀態(tài)而不是讓 Promise 自指。12. Error: cannot await properties of a non-object觸發(fā)場景.props方法期望接收一個對象但你傳入了非對象值或一個 resolve 成非對象的 Promise。正確用法是傳入一個屬性值為 Promise 的對象Promise.props({ pictures: getPictures(), comments: getComments(), tweets: getTweets() }).then(function(result){ console.log(result.tweets, result.pictures, result.comments); });原因分析在 src/props.js 中function props(promises) { var ret; var castValue tryConvertToPromise(promises); if (!isObject(castValue)) { return apiRejection(PROPS_TYPE_ERROR); } ... }當輸入既不是對象也不是 Promise 時返回以PROPS_TYPE_ERROR定義于 src/constants.js為原因的 rejected promise。補充說明props同樣支持 ES6Map——從源碼看若傳入的是Map實例會通過mapToEntries提取條目并在全部解決后還原為Map見 src/props.js這是比文檔示例更進一步的輸入形態(tài)。13. Error: expecting a positive integer觸發(fā)場景調用.some()時傳入了負數(shù)或非整數(shù)作為howMany參數(shù)。文檔特別提醒Array.prototype.indexOf在找不到目標時會返回-1如果把這個-1直接傳給.some()就會觸發(fā)本錯誤。原因分析在 src/some.js 中function some(promises, howMany) { if ((howMany | 0) ! howMany || howMany 0) { return apiRejection(POSITIVE_INTEGER_ERROR); } ... }(howMany | 0) ! howMany用位運算檢查是否為整數(shù)非整數(shù)經過| 0會丟失小數(shù)部分而不再相等howMany 0檢查正負。POSITIVE_INTEGER_ERROR定義于 src/constants.js。修復思路確保傳給.some()的計數(shù)是大于等于 0 的整數(shù)例如indexOf的返回值需要先判斷是否為-1。API 細節(jié)見 .some。14. Error: A value was yielded that could not be treated as a promise觸發(fā)場景在協(xié)程coroutine中yield了一個無法被當作 Promise 處理的值并且沒有注冊對應的 yield handler。文檔示例var coroutine Promise.coroutine(function*(){ var bar yield Foo; console.log(bar); });Foo是一個字符串不是 Promise、thenable 或任何已注冊 handler 可識別的類型。原因分析在 src/generators.js 的PromiseSpawn.prototype._continue中yield 出的值先嘗試tryConvertToPromise失敗后再逐一嘗試 yield handlerspromiseFromYieldHandler如果仍然得不到 Promise則if (maybePromise null) { this._promiseRejected( new TypeError( YIELDED_NON_PROMISE_ERROR.replace(%s, String(value)) FROM_COROUTINE_CREATED_AT this._stack.split(\n).slice(1, -7).join(\n) ) ); return; }注意錯誤信息中會拼接From coroutine:及當時的調用棧片段便于定位協(xié)程中的具體 yield 位置。修復方案兩種方案一把值顯式轉換為 Promisevar coroutine Promise.coroutine(function*(){ var bar yield Promise.resolve(Foo); console.log(bar); });如果該值是回調風格先用Promise.promisify包裝。方案二使用 Promise.coroutine.addYieldHandler 教會Promise.coroutine接受這類值從而在所有協(xié)程中統(tǒng)一處理。15. Error: Cannot promisify an API that has normal methods觸發(fā)場景對某個對象調用Promise.promisifyAll時發(fā)現(xiàn)該對象已經存在以Async結尾的屬性var myApi { foo: function(cb){ ... }, fooAsync(cb) { ... } }原因分析Bluebird 通過給原始方法名追加Async后綴來生成 promisified 版本默認后綴Async定義于 src/constants.js 的AFTER_PROMISIFIED_SUFFIX。如果原對象已經有一個fooAsync屬性promisify 后生成的fooAsync就會覆蓋原有的fooAsync造成沖突。在 src/promisify.js 中checkValid會預先掃描待 promisify 的方法列表function checkValid(ret, suffix, suffixRegexp) { for (var i 0; i ret.length; i 2) { var key ret[i]; if (suffixRegexp.test(key)) { var keyWithoutAsyncSuffix key.replace(suffixRegexp, ); for (var j 0; j ret.length; j 2) { if (ret[j] keyWithoutAsyncSuffix) { throw new TypeError(PROMISIFICATION_NORMAL_METHODS_ERROR .replace(%s, suffix)); } } } } }一旦發(fā)現(xiàn)存在xxx且同時存在xxxAsync就拋出該錯誤PROMISIFICATION_NORMAL_METHODS_ERROR定義于 src/constants.js。修復方案三種提前改名在 promisify 之前把對象上已有的fooAsync等屬性重命名避免沖突手動選擇性 promisify改用Promise.promisify逐個包裝需要的屬性自定義后綴通過Promise.promisifyAll(obj, { suffix: Async2 })之類的選項換一個不會沖突的后綴——suffix必須是合法標識符src/promisify.js 中會用SUFFIX_NOT_IDENTIFIER校驗。16. Error: Catch filter must inherit from Error or be a simple predicate function觸發(fā)場景使用類型化typed或謂詞predicate形式的.catch()時過濾器不符合要求。原因分析Bluebird 支持兩類.catch()過濾器其底層實現(xiàn)在 src/catch_filter.js第一類類型過濾器——傳入一個繼承自Error的構造器}).catch(ReferenceError, function(e) { // 這是可以的 }).catch(Array, function(e) { // 數(shù)組不捕獲堆棧不建議源碼中對應的判定是item Error || (item ! null item.prototype instanceof Error)隨后用e instanceof item匹配異常類型。要求構造器繼承自Error是為了獲得更好的堆棧追蹤支持也讓錯誤處理邏輯更一致、更清晰。第二類謂詞過濾器——傳入一個簡單函數(shù)接受異常對象、返回布爾值}).catch(function(e){ return false; }, function(e) { // 這個會捕獲不到任何東西 }).catch(function(e){ return e.someProp 5; }, function(e) { // 這是可以的源碼中typeof item function分支會調用謂詞tryCatch(item).call(boundTo, e)返回值真值則進入處理函數(shù)。修復思路確保.catch()第一個參數(shù)要么是Error的子類構造器要么是返回真值的簡單謂詞函數(shù)不要在謂詞里做會改變e的賦值操作示例中e.someProp 5只是展示返回真值即可實際業(yè)務中應寫return e.someProp 5;。完整的謂詞 catch 用法見 .catch()。17. Error: No async scheduler available觸發(fā)場景運行環(huán)境的 JavaScript 運行時沒有暴露 Bluebird 默認嘗試的任何一種異步調度器。背景知識異步調度器async scheduler是一個接收回調函數(shù)并盡快但異步地調用它的函數(shù)例如setTimeout。原因分析在 src/schedule.js 中Bluebird 按優(yōu)先級探測常見的調度器Node.js 環(huán)境下使用setImmediate新版 Node或process.nextTick舊版 Node有原生 Promise 時用nativePromise.then(fn)瀏覽器中優(yōu)先使用MutationObserver低延遲但會排除 iOS 8.3 standalone 與 cordova 等存在 bug 的環(huán)境退而求其次使用setImmediate再退而求其次使用setTimeout(fn, 0)全部不存在時schedule被設為noAsyncSchedulervar noAsyncScheduler function() { throw new Error(NO_ASYNC_SCHEDULER); };注釋強調絕不能默認使用同步調度器否則會破壞 Promises/A 合規(guī)性并引發(fā)競態(tài)條件。因此在不提供任何上述調度器的環(huán)境如某些嵌入式 JS 運行時中就會拋出NO_ASYNC_SCHEDULER定義于 src/constants.js。修復方案使用 Promise.setScheduler 傳入當前環(huán)境支持的調度器。文檔給出的 DukTape 示例Promise.setScheduler(function(fn){ // fn 就是要執(zhí)行的函數(shù) var timer uv.new_timer.call({}); uv.timer_start(timer, 0, 0, fn); // 把函數(shù)掛到定時器回調上 });Promise.setScheduler會校驗參數(shù)必須是函數(shù)src/promise.js并交給async.setScheduler替換內部調度策略。注意文檔提示不同環(huán)境DukTape、舊版 IE 等可用的調度手段不同自定義調度器是讓 Bluebird 在受限環(huán)境中跑起來的兜底方案。小結Bluebird 錯誤設計的三個特征縱觀以上 17 個錯誤可以發(fā)現(xiàn) Bluebird 的報錯設計遵循三個原則理解它們能幫你更快定位問題參數(shù)即契約幾乎所有入口promisify、promisifyAll、coroutine、setScheduler、some、props等都會在第一時間校驗參數(shù)類型并拋出帶固定文案的TypeError/RangeError錯誤文案集中定義于 src/constants.js 的常量表中便于在文檔與源碼間互相檢索同步錯誤 vs 拒絕 Promise對編譯期語義的調用如Promise.coroutine選擇同步拋錯對運行期數(shù)據(jù)的調用如Promise.some收到非法計數(shù)、Promise.props收到非對象則返回rejected promise通過apiRejection這一區(qū)分在 src/generators.js 與 src/some.js 的注釋中均有明確說明狀態(tài)與方法綁定同步檢查.value()/.reason()必須在正確的 Promise 狀態(tài)下調用否則拋錯——這是 Bluebird 把檢查先于取值的理念落實到了 API 設計上見 src/synchronous_inspection.js。掌握這些錯誤信息的成因與修復方式再配合 API 參考 與各方法文檔如 new Promise、Promise.promisify、Promise.coroutine、.catch()、synchronous inspection就能在 Bluebird 項目中寫出更健壯、更少踩坑的異步代碼。贊分享后端【免費下載鏈接】bluebird:bird: :zap: Bluebird is a full featured promise library with unmatched performance.項目地址https://gitcode.com/gh_mirrors/bl/bluebird點擊查看免費下載相關推薦Angular AOT 元數(shù)據(jù)錯誤全解析11 類典型報錯信息、成因與修復方案Angular AOT 元數(shù)據(jù)錯誤全解析11 類典型報錯信息、成因與修復方案 本篇技術指南基于 Angular 官方文檔「AOT metadata error前端Web框架Cardinal終極指南如何快速上手開源模塊合成器插件Cardinal終極指南如何快速上手開源模塊合成器插件 Cardinal是一款功能強大的開源虛擬模塊合成器插件它為音樂制作愛好者和專業(yè)人士提供了一個靈活且強教程抖音批量下載工具怎么用douyin-downloader 免費無水印下載完整指南抖音批量下載工具怎么用douyin downloader 免費無水印下載完整指南 如果你想把喜歡的抖音視頻、原聲音樂、圖集乃至整場直播存到本地 douyin網頁爬蟲CLI上一篇從nvm到n工具5步終極遷移指南讓Node.js版本管理飛起來下一篇NES.css版本歷史重要更新回顧創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考