1. Promise 的含義

所謂Promise，簡單說就是一個容器，里面保存著某個未來才會結束的事件（通常是一個異步操作）的結果。從語法上說，Promise 是一個對象，從它可以獲取異步操作的消息。Promise 提供統(tǒng)一的 API，各種異步操作都可以用同樣的方法進行處理。

Promise對象有以下兩個特點。

（1）對象的狀態(tài)不受外界影響。Promise對象代表一個異步操作，有三種狀態(tài)：pending（進行中）、fulfilled（已成功）和rejected（已失?。?。只有異步操作的結果，可以決定當前是哪一種狀態(tài)，任何其他操作都無法改變這個狀態(tài)。這也是Promise這個名字的由來，它的英語意思就是“承諾”，表示其他手段無法改變。

（2）一旦狀態(tài)改變，就不會再變，任何時候都可以得到這個結果。Promise對象的狀態(tài)改變，只有兩種可能：從pending變?yōu)閒ulfilled和從pending變?yōu)閞ejected。只要這兩種情況發(fā)生，狀態(tài)就凝固了，不會再變了，會一直保持這個結果，這時就稱為 resolved（已定型）。如果改變已經發(fā)生了，你再對Promise對象添加回調函數，也會立即得到這個結果。這與事件（Event）完全不同，事件的特點是，如果你錯過了它，再去監(jiān)聽，是得不到結果的。

Promise也有一些缺點。首先，無法取消Promise，一旦新建它就會立即執(zhí)行，無法中途取消。其次，如果不設置回調函數，Promise內部拋出的錯誤，不會反應到外部。第三，當處于pending狀態(tài)時，無法得知目前進展到哪一個階段（剛剛開始還是即將完成）。

2. 基本用法

ES6 規(guī)定，Promise對象是一個構造函數，用來生成Promise實例。

下面代碼創(chuàng)造了一個Promise實例。

const promise = new Promise(function(resolve, reject) {
  // ... some code

  if (/* 異步操作成功 */){
    resolve(value);
  } else {
    reject(error);
  }
});

Promise構造函數接受一個函數作為參數，該函數的兩個參數分別是resolve和reject。它們是兩個函數，由 JavaScript 引擎提供，不用自己部署。

resolve函數的作用是，將Promise對象的狀態(tài)從“未完成”變?yōu)椤俺晒Α保磸?pending 變?yōu)?resolved），在異步操作成功時調用，并將異步操作的結果，作為參數傳遞出去；reject函數的作用是，將Promise對象的狀態(tài)從“未完成”變?yōu)椤笆　保磸?pending 變?yōu)?rejected），在異步操作失敗時調用，并將異步操作報出的錯誤，作為參數傳遞出去。

Promise 新建后就會立即執(zhí)行。

let promise = new Promise(function(resolve, reject) {
  console.log('Promise');
  resolve();
});

promise.then(function() {
  console.log('resolved.');
});

console.log('Hi!');

// Promise
// Hi!
// resolved

上面代碼中，Promise 新建后立即執(zhí)行，所以首先輸出的是Promise。然后，then方法指定的回調函數，將在當前腳本所有同步任務執(zhí)行完才會執(zhí)行，所以resolved最后輸出

如果調用resolve函數和reject函數時帶有參數，那么它們的參數會被傳遞給回調函數。reject函數的參數通常是Error對象的實例，表示拋出的錯誤；resolve函數的參數除了正常的值以外，還可能是另一個 Promise 實例，比如像下面這樣。

const p1 = new Promise(function (resolve, reject) {
  // ...
});

const p2 = new Promise(function (resolve, reject) {
  // ...
  resolve(p1);
})

上面代碼中，p1和p2都是 Promise 的實例，但是p2的resolve方法將p1作為參數，即一個異步操作的結果是返回另一個異步操作。

注意，這時p1的狀態(tài)就會傳遞給p2，也就是說，p1的狀態(tài)決定了p2的狀態(tài)。如果p1的狀態(tài)是pending，那么p2的回調函數就會等待p1的狀態(tài)改變；如果p1的狀態(tài)已經是resolved或者rejected，那么p2的回調函數將會立刻執(zhí)行。

const p1 = new Promise(function (resolve, reject) {
  setTimeout(() => reject(new Error('fail')), 3000)
})

const p2 = new Promise(function (resolve, reject) {
  setTimeout(() => resolve(p1), 1000)
})

p2
  .then(result => console.log(result))
  .catch(error => console.log(error))
// Error: fail

上面代碼中，p1是一個 Promise，3 秒之后變?yōu)閞ejected。p2的狀態(tài)在 1 秒之后改變，resolve方法返回的是p1。由于p2返回的是另一個 Promise，導致p2自己的狀態(tài)無效了，由p1的狀態(tài)決定p2的狀態(tài)。所以，后面的then語句都變成針對后者（p1）。又過了 2 秒，p1變?yōu)閞ejected，導致觸發(fā)catch方法指定的回調函數。

注意，調用resolve或reject并不會終結 Promise 的參數函數的執(zhí)行。

new Promise((resolve, reject) => {
  resolve(1);
  console.log(2);
}).then(r => {
  console.log(r);
});
// 2
// 1

上面代碼中，調用resolve(1)以后，后面的console.log(2)還是會執(zhí)行，并且會首先打印出來。這是因為立即 resolved 的 Promise 是在本輪事件循環(huán)的末尾執(zhí)行，總是晚于本輪循環(huán)的同步任務。

一般來說，調用resolve或reject以后，Promise 的使命就完成了，后繼操作應該放到then方法里面，而不應該直接寫在resolve或reject的后面。所以，最好在它們前面加上return語句，這樣就不會有意外。

3. Promise.prototype.then()

Promise 實例具有then方法，也就是說，then方法是定義在原型對象Promise.prototype上的。它的作用是為 Promise 實例添加狀態(tài)改變時的回調函數。前面說過，then方法的第一個參數是resolved狀態(tài)的回調函數，第二個參數（可選）是rejected狀態(tài)的回調函數。

then方法返回的是一個新的Promise實例（注意，不是原來那個Promise實例）。因此可以采用鏈式寫法，即then方法后面再調用另一個then方法。

getJSON("/posts.json").then(function(json) {
  return json.post;
}).then(function(post) {
  // ...
});

上面的代碼使用then方法，依次指定了兩個回調函數。第一個回調函數完成以后，會將返回結果作為參數，傳入第二個回調函數。

采用鏈式的then，可以指定一組按照次序調用的回調函數。這時，前一個回調函數，有可能返回的還是一個Promise對象（即有異步操作），這時后一個回調函數，就會等待該Promise對象的狀態(tài)發(fā)生變化，才會被調用。

4. Promise.prototype.catch()

Promise.prototype.catch方法是.then(null, rejection)的別名，用于指定發(fā)生錯誤時的回調函數。

getJSON('/posts.json').then(function(posts) {
  // ...
}).catch(function(error) {
  // 處理 getJSON 和 前一個回調函數運行時發(fā)生的錯誤
  console.log('發(fā)生錯誤！', error);
});

上面代碼中，getJSON方法返回一個 Promise 對象，如果該對象狀態(tài)變?yōu)閞esolved，則會調用then方法指定的回調函數；如果異步操作拋出錯誤，狀態(tài)就會變?yōu)閞ejected，就會調用catch方法指定的回調函數，處理這個錯誤。另外，then方法指定的回調函數，如果運行中拋出錯誤，也會被catch方法捕獲

p.then((val) => console.log('fulfilled:', val))
  .catch((err) => console.log('rejected', err));

// 等同于
p.then((val) => console.log('fulfilled:', val))
  .then(null, (err) => console.log("rejected:", err));

下面是一個例子

const promise = new Promise(function(resolve, reject) {
  throw new Error('test');
});
promise.catch(function(error) {
  console.log(error);
});
// Error: test

上面代碼中，promise拋出一個錯誤，就被catch方法指定的回調函數捕獲。注意，上面的寫法與下面兩種寫法是等價的。

// 寫法一
const promise = new Promise(function(resolve, reject) {
  try {
    throw new Error('test');
  } catch(e) {
    reject(e);
  }
});
promise.catch(function(error) {
  console.log(error);
});

// 寫法二
const promise = new Promise(function(resolve, reject) {
  reject(new Error('test'));
});
promise.catch(function(error) {
  console.log(error);
});

比較上面兩種寫法，可以發(fā)現reject方法的作用，等同于拋出錯誤。
如果 Promise 狀態(tài)已經變成resolved，再拋出錯誤是無效的。

const promise = new Promise(function(resolve, reject) {
  resolve('ok');
  throw new Error('test');
});
promise
  .then(function(value) { console.log(value) })
  .catch(function(error) { console.log(error) });
// ok

因為 Promise 的狀態(tài)一旦改變，就永久保持該狀態(tài)，不會再變了。

Promise 對象的錯誤具有“冒泡”性質，會一直向后傳遞，直到被捕獲為止。也就是說，錯誤總是會被下一個catch語句捕獲。

getJSON('/post/1.json').then(function(post) {
  return getJSON(post.commentURL);
}).then(function(comments) {
  // some code
}).catch(function(error) {
  // 處理前面三個Promise產生的錯誤
});

上面代碼中，一共有三個 Promise 對象：一個由getJSON產生，兩個由then產生。它們之中任何一個拋出的錯誤，都會被最后一個catch捕獲。

一般來說，不要在then方法里面定義 Reject 狀態(tài)的回調函數（即then的第二個參數），總是使用catch方法。

跟傳統(tǒng)的try/catch代碼塊不同的是，如果沒有使用catch方法指定錯誤處理的回調函數，Promise 對象拋出的錯誤不會傳遞到外層代碼，即不會有任何反應。

const someAsyncThing = function() {
  return new Promise(function(resolve, reject) {
    // 下面一行會報錯，因為x沒有聲明
    resolve(x + 2);
  });
};

someAsyncThing().then(function() {
  console.log('everything is great');
});

setTimeout(() => { console.log(123) }, 2000);
// Uncaught (in promise) ReferenceError: x is not defined
// 123

上面代碼中，someAsyncThing函數產生的 Promise 對象，內部有語法錯誤。瀏覽器運行到這一行，會打印出錯誤提示ReferenceError: x is not defined，但是不會退出進程、終止腳本執(zhí)行，2 秒之后還是會輸出123。這就是說，Promise 內部的錯誤不會影響到 Promise 外部的代碼，通俗的說法就是“Promise 會吃掉錯誤”。

這個腳本放在服務器執(zhí)行，退出碼就是0（即表示執(zhí)行成功）。不過，Node 有一個unhandledRejection事件，專門監(jiān)聽未捕獲的reject錯誤，上面的腳本會觸發(fā)這個事件的監(jiān)聽函數，可以在監(jiān)聽函數里面拋出錯誤。

process.on('unhandledRejection', function (err, p) {
  throw err;
});

上面代碼中，unhandledRejection事件的監(jiān)聽函數有兩個參數，第一個是錯誤對象，第二個是報錯的 Promise 實例，它可以用來了解發(fā)生錯誤的環(huán)境信息。

注意，Node 有計劃在未來廢除unhandledRejection事件。如果 Promise 內部有未捕獲的錯誤，會直接終止進程，并且進程的退出碼不為 0。

再看下面的例子。

const promise = new Promise(function (resolve, reject) {
  resolve('ok');
  setTimeout(function () { throw new Error('test') }, 0)
});
promise.then(function (value) { console.log(value) });
// ok
// Uncaught Error: test

上面代碼中，Promise 指定在下一輪“事件循環(huán)”再拋出錯誤。到了那個時候，Promise 的運行已經結束了，所以這個錯誤是在 Promise 函數體外拋出的，會冒泡到最外層，成了未捕獲的錯誤。
一般總是建議，Promise 對象后面要跟catch方法，這樣可以處理 Promise 內部發(fā)生的錯誤。catch方法返回的還是一個 Promise 對象，因此后面還可以接著調用then方法。

const someAsyncThing = function() {
  return new Promise(function(resolve, reject) {
    // 下面一行會報錯，因為x沒有聲明
    resolve(x + 2);
  });
};

someAsyncThing()
.catch(function(error) {
  console.log('oh no', error);
})
.then(function() {
  console.log('carry on');
});
// oh no [ReferenceError: x is not defined]
// carry on

上面代碼運行完catch方法指定的回調函數，會接著運行后面那個then方法指定的回調函數。如果沒有報錯，則會跳過catch方法。

Promise.resolve()
.catch(function(error) {
  console.log('oh no', error);
})
.then(function() {
  console.log('carry on');
});
// carry on

上面的代碼因為沒有報錯，跳過了catch方法，直接執(zhí)行后面的then方法。此時，要是then方法里面報錯，就與前面的catch無關了。
catch方法之中，還能再拋出錯誤

const someAsyncThing = function() {
  return new Promise(function(resolve, reject) {
    // 下面一行會報錯，因為x沒有聲明
    resolve(x + 2);
  });
};
someAsyncThing().then(function() {
  return someOtherAsyncThing();
}).catch(function(error) {
  document.write('oh  error' + "<br>");

  // 下面一行會報錯，因為y沒有聲明
  y + 2;
}).catch(function(error) {
  document.write('carry on error' + "<br>");

});
// oh no [ReferenceError: x is not defined]
// carry on [ReferenceError: y is not defined]

5. Promise.all()

Promise.all方法用于將多個 Promise 實例，包裝成一個新的 Promise 實例。

const p = Promise.all([p1, p2, p3]);

上面代碼中，Promise.all方法接受一個數組作為參數，p1、p2、p3都是 Promise 實例，如果不是，就會先調用下面講到的Promise.resolve方法，將參數轉為 Promise 實例，再進一步處理。（Promise.all方法的參數可以不是數組，但必須具有 Iterator 接口，且返回的每個成員都是 Promise 實例。）

p的狀態(tài)由p1、p2、p3決定，分成兩種情況。

（1）只有p1、p2、p3的狀態(tài)都變成fulfilled，p的狀態(tài)才會變成fulfilled，此時p1、p2、p3的返回值組成一個數組，傳遞給p的回調函數。

（2）只要p1、p2、p3之中有一個被rejected，p的狀態(tài)就變成rejected，此時第一個被reject的實例的返回值，會傳遞給p的回調函數。

下面是一個具體的例子。

// 生成一個Promise對象的數組
const promises = [2, 3, 5, 7, 11, 13].map(function (id) {
  return getJSON('/post/' + id + ".json");
});

Promise.all(promises).then(function (posts) {
  // ...
}).catch(function(reason){
  // ...
});

上面代碼中，promises是包含 6 個 Promise 實例的數組，只有這 6 個實例的狀態(tài)都變成fulfilled，或者其中有一個變?yōu)閞ejected，才會調用Promise.all方法后面的回調函數

注意，如果作為參數的 Promise 實例，自己定義了catch方法，那么它一旦被rejected，并不會觸發(fā)Promise.all()的catch方法。

const p1 = new Promise((resolve, reject) => {
  resolve('hello');
})
.then(result => result)
.catch(e => e);

const p2 = new Promise((resolve, reject) => {
  throw new Error('報錯了');
})
.then(result => result)
.catch(e => e);

Promise.all([p1, p2])
.then(result => console.log(result))
.catch(e => console.log(e));
// ["hello", Error: 報錯了]

上面代碼中，p1會resolved，p2首先會rejected，但是p2有自己的catch方法，該方法返回的是一個新的 Promise 實例，p2指向的實際上是這個實例。該實例執(zhí)行完catch方法后，也會變成resolved，導致Promise.all()方法參數里面的兩個實例都會resolved，因此會調用then方法指定的回調函數，而不會調用catch方法指定的回調函數。

如果p2沒有自己的catch方法，就會調用Promise.all()的catch方法

6. Promise.race

Promise.race方法同樣是將多個 Promise 實例，包裝成一個新的 Promise 實例。

const p = Promise.race([p1, p2, p3]);

面代碼中，只要p1、p2、p3之中有一個實例率先改變狀態(tài)，p的狀態(tài)就跟著改變。那個率先改變的 Promise 實例的返回值，就傳遞給p的回調函數。

Promise.race方法的參數與Promise.all方法一樣，如果不是 Promise 實例，就會先調用下面講到的Promise.resolve方法，將參數轉為 Promise 實例，再進一步處理。

下面是一個例子，如果指定時間內沒有獲得結果，就將 Promise 的狀態(tài)變?yōu)閞eject，否則變?yōu)閞esolve。

const p = Promise.race([
  fetch('/resource-that-may-take-a-while'),
  new Promise(function (resolve, reject) {
    setTimeout(() => reject(new Error('request timeout')), 5000)
  })
]);
p.then(response => console.log(response));
p.catch(error => console.log(error));

上面代碼中，如果 5 秒之內fetch方法無法返回結果，變量p的狀態(tài)就會變?yōu)閞ejected，從而觸發(fā)catch方法指定的回調函數。

7. Promise.resolve()

有時需要將現有對象轉為 Promise 對象，Promise.resolve方法就起到這個作用

Promise.resolve等價于下面的寫法。

romise.resolve('foo')
// 等價于
new Promise(resolve => resolve('foo'))

Promise.resolve方法的參數分成四種情況。

（1）參數是一個 Promise 實例

如果參數是 Promise 實例，那么Promise.resolve將不做任何修改、原封不動地返回這個實例。

（2）參數是一個thenable對象

thenable對象指的是具有then方法的對象，比如下面這個對象

let thenable = {
  then: function(resolve, reject) {
    resolve(42);
  }
};

Promise.resolve方法會將這個對象轉為 Promise 對象，然后就立即執(zhí)行thenable對象的then方法。

let thenable = {
  then: function(resolve, reject) {
    resolve(42);
  }
};

let p1 = Promise.resolve(thenable);
p1.then(function(value) {
  console.log(value);  // 42
});

上面代碼中，thenable對象的then方法執(zhí)行后，對象p1的狀態(tài)就變?yōu)閞esolved，從而立即執(zhí)行最后那個then方法指定的回調函數，輸出 42。

（3）參數不是具有then方法的對象，或根本就不是對象

如果參數是一個原始值，或者是一個不具有then方法的對象，則Promise.resolve方法返回一個新的 Promise 對象，狀態(tài)為resolved。

const p = Promise.resolve('Hello');

p.then(function (s){
  console.log(s)
});
// Hello

上面代碼生成一個新的 Promise 對象的實例p。由于字符串Hello不屬于異步操作（判斷方法是字符串對象不具有 then 方法），返回 Promise 實例的狀態(tài)從一生成就是resolved，所以回調函數會立即執(zhí)行。Promise.resolve方法的參數，會同時傳給回調函數。

（4）不帶有任何參數

Promise.resolve方法允許調用時不帶參數，直接返回一個resolved狀態(tài)的 Promise 對象。

所以，如果希望得到一個 Promise 對象，比較方便的方法就是直接調用Promise.resolve方法。

const p = Promise.resolve();

p.then(function () {
  // ...
});

上面代碼的變量p就是一個 Promise 對象。

需要注意的是，立即resolve的 Promise 對象，是在本輪“事件循環(huán)”（event loop）的結束時，而不是在下一輪“事件循環(huán)”的開始時。

setTimeout(function () {
  console.log('three');
}, 0);

Promise.resolve().then(function () {
  console.log('two');
});

console.log('one');

// one
// two
// three

上面代碼中，setTimeout(fn, 0)在下一輪“事件循環(huán)”開始時執(zhí)行，Promise.resolve()在本輪“事件循環(huán)”結束時執(zhí)行，console.log('one')則是立即執(zhí)行，因此最先輸出。

8. Promise.reject()

Promise.reject(reason)方法也會返回一個新的 Promise 實例，該實例的狀態(tài)為rejected。

const p = Promise.reject('出錯了');
// 等同于
const p = new Promise((resolve, reject) => reject('出錯了'))

p.then(null, function (s) {
  console.log(s)
});
// 出錯了

上面代碼生成一個 Promise 對象的實例p，狀態(tài)為rejected，回調函數會立即執(zhí)行。

注意，Promise.reject()方法的參數，會原封不動地作為reject的理由，變成后續(xù)方法的參數。這一點與Promise.resolve方法不一致。

const thenable = {
  then(resolve, reject) {
    reject('出錯了');
  }
};

Promise.reject(thenable)
.catch(e => {
  console.log(e === thenable)
})
// true

上面代碼中，Promise.reject方法的參數是一個thenable對象，執(zhí)行以后，后面catch方法的參數不是reject拋出的“出錯了”這個字符串，而是thenable對象。

轉自 阮一峰 ECMAScript 6 入門