DIV CSS 佈局教程網

JavaScript Promise 完全指南:用法、串接與組合
編輯:關於JavaScript     

同步程式碼易於閱讀除錯,異步程式碼則換來效能與靈活性。異步最大的特點是「不必等」,而 Promise 正是馴服這份複雜度的主流方案——大量現代 Web API 都已採用 Promise 作為基礎。

Promise 的現狀

有趣的是,XMLHttpRequest 本身是異步的卻沒有用 Promise,反倒是不少較新的原生 API 直接以 Promise 設計:

  • Battery API
  • fetch API(XHR 的現代替代品)
  • Service Worker API

Node.js 生態同樣深度依賴 Promise。可以確定的是,所有前端開發者遲早都會用到它。

基本用法

var p = new Promise(function (resolve, reject) {
  // 執行異步任務
  if (/* 條件良好 */) {
    resolve('Success!');
  } else {
    reject('Failure!');
  }
});

p.then(function (result) {
  // 處理成功結果
}).catch(function (err) {
  // 處理失敗
});

構造器提供 resolve 與 reject 兩個函數,由開發者在回呼內部依執行結果手動呼叫。

實戰:把 XHR 包裝成 Promise

function get(url) {
  return new Promise(function (resolve, reject) {
    var req = new XMLHttpRequest();
    req.open('GET', url);

    req.onload = function () {
      // 注意:即使 404 也會觸發 onload,所以必須檢查狀態碼
      if (req.status == 200) {
        resolve(req.response);
      } else {
        reject(Error(req.statusText));
      }
    };

    req.onerror = function () {
      reject(Error("Network Error"));
    };

    req.send();
  });
}

get('story.json').then(function (response) {
  console.log("Success!", response);
}, function (error) {
  console.error("Failed!", error);
});

Promise.resolve 與 Promise.reject

當你「確定要回傳一個已完成的 Promise」而不需要真的走 new 流程時,這兩個靜態方法可以省下不少字:

var userCache = {};

function getUserDetail(username) {
  if (userCache[username]) {
    // 命中快取,直接回傳已 resolve 的 Promise
    return Promise.resolve(userCache[username]);
  }
  return fetch('users/' + username + '.json')
    .then(function (result) {
      userCache[username] = result;
      return result;
    })
    .catch(function () {
      throw new Error('Could not find user: ' + username);
    });
}

不管走哪個分支,呼叫方都能一律用 then / catch 處理,介面保持一致。

then:串接的核心

new Promise(function (resolve) {
  setTimeout(function () { resolve(10); }, 3000);
}).then(function (num) {
  console.log('first then: ', num);   // 10
  return num * 2;
}).then(function (num) {
  console.log('second then: ', num);  // 20
  return num * 2;
}).then(function (num) {
  console.log('last then: ', num);    // 40
});

每個 then 回呼的參數,就是上一個 then 回呼的返回值;若上一環回傳的是 Promise,下一環會等它 settle 後才繼續。這正是 Promise 消滅「回呼地獄」的機制。

另一個特性:Promise 的狀態一旦確定便不可逆。若已 resolve,後續再掛 then 仍會執行;若已 reject,後掛的 then 成功回呼不會被觸發。

catch:捕捉被拒絕的狀態

new Promise(function (resolve, reject) {
  setTimeout(function () { reject('Done!'); }, 3000);
}).then(function (e) {
  console.log('done', e);
}).catch(function (e) {
  console.log('catch: ', e);   // "catch: Done!"
});

慣例是傳 Error 物件而非裸字符串,這樣才有完整的堆疊資訊:

reject(Error('Data could not be found'));

另外 catch 也會攔下前面 then 回呼中拋出的例外,等價於 then(null, onRejected)。

Promise.all:全部完成才繼續

需要並行發出多個請求、但希望等全部回來才做下一步時,這就是答案:

Promise.all([promise1, promise2])
  .then(function (results) {
    // 兩個都成功
  })
  .catch(function (error) {
    // 其中任一被拒絕
  });
var request1 = fetch('/users.json');
var request2 = fetch('/articles.json');

Promise.all([request1, request2]).then(function (results) {
  // results 是依參數順序排列的回應陣列
});

不同 API 也能混用,因為它們都回傳 Promise:

Promise.all([fetch('/users.json'), navigator.getBattery()])
  .then(function (results) { /* 都完成了 */ });

只要有一個 reject,catch 就會抓到「最先」被拒絕的那個:

var req1 = new Promise(function (resolve) {
  setTimeout(function () { resolve('First!'); }, 4000);
});
var req2 = new Promise(function (resolve, reject) {
  setTimeout(function () { reject('Second!'); }, 3000);
});

Promise.all([req1, req2])
  .then(function (results) { console.log('Then: ', results); })
  .catch(function (err) { console.log('Catch: ', err); });
// Catch: Second!

要注意的是,Promise.all 失敗時其他已成功的結果會被丟棄。若需要「容錯版」的等待全部結果,可自行實作 allSettled 邏輯(ES2020 已內建 Promise.allSettled)。

Promise.race:誰先完成就用誰

var req1 = new Promise(function (resolve) {
  setTimeout(function () { resolve('First!'); }, 8000);
});
var req2 = new Promise(function (resolve) {
  setTimeout(function () { resolve('Second!'); }, 3000);
});

Promise.race([req1, req2]).then(function (one) {
  console.log('Then: ', one);   // Second!
});

它不等全部,只要有一個 settle 就立刻回傳該結果(成功或失敗都算)。典型用途是從多個鏡像節點同時抓資源、誰先回就用誰,或是實作請求逾時:

function withTimeout(promise, ms) {
  var timeout = new Promise(function (resolve, reject) {
    setTimeout(function () { reject(Error('Timeout')); }, ms);
  });
  return Promise.race([promise, timeout]);
}

把 Promise 學起來

Promise 從一個技術名詞演變成 JavaScript 語言架構的一部分,後續的 async/await 更是直接建立在它之上——await 背後等的就是一個 Promise。理解 then 串接、狀態不可逆、以及 all / race 的組合語意,等於掌握了現代非同步程式設計的基礎。往後看到越多新的 Web API 以 Promise 形式出現,你都不會感到陌生。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved