Promise基礎用法

風雪中的兔子發表於2019-03-27
Promise

什麼是Promise？

  • Promise是用來處理非同步的;
  • Promise就是承諾,對未來的承諾;
  • 所謂的Promise(承諾),裡面儲存著未來才會結束的事件的結果;
  • Promise是非同步程式設計的一種解決方案; 比傳統的解決方案(回撥函式和事件)更合理更強大;
  • Promise一個物件，從它可以獲取非同步操作的訊息；
  • Promise最大的好處是在非同步執行的流程中，把執行程式碼和處理結果的程式碼清晰地分離了

兩個特點

  • 物件的狀態不受外界影響, Promise物件代表一個非同步操作;

3種狀態

1 pending 	等待態
2 fulfilled 已成功
3 rejected  已失敗

只有非同步操作的結果,可以決定當前是哪一個狀態,任何外部的操作都無法改變這個狀態
複製程式碼
  • 狀態一旦改變,就不會也不能再變,任何時候都可以得到這個結果; Promise的狀態,只能從pending變為fulfilled或rejected, fulfilled和rejected不能相互轉換;

誕生的時代背景

在JavaScript的世界中,所有程式碼都是單執行緒執行的;由於這個"缺陷",以至於JavaScript的所有網路操作、瀏覽器事件等都必須非同步執行; 非同步意味著在未來的某個時刻得到結果; 在promise之前,我們寫的ajax應用(前一個函式的執行結果作為下一個函式的引數),就面臨著大量的回撥函式的窘境,回撥函式的多層巢狀成為我們繞不開的噩夢;

為解決回撥而生

  • Promise物件,可以將非同步操作以同步的流程表達出來,避免了層層巢狀的回撥函式;
  • Promise物件提供統一的介面,使得控制非同步更加容易;

不是最perfect, 因為它還是基於回撥

  • 無法取消Promise,一旦新建就會立即執行,無法中途取消;
  • 如果不設定回撥函式,Promise內部丟擲的錯誤,不會反應到外部;
  • 當處於pending時,無法得知目前進展到哪一個階段(剛剛開始還是即將完成)
  • 從本質上來說,Promise還是基於回撥的

基礎用法

一、建構函式與then

  • ES6規定,Promise物件是一個建構函式,用來生成Promise例項

  • Promise接收一個函式(executor:執行者)作為引數,該函式有兩個引數:

    1 resolve(Function) -> 將Promise物件的狀態從"未完成pending"變為"成功resolved",在非同步操作成時呼叫,並將非同步操作的結果,作為引數傳遞出去(供then方法的成功回撥接收)

    2 reject(Function) -> 將Promise物件的狀態從"未完成pending"變為"rejected",在非同步失敗時呼叫,並將非同步操作的錯誤或失敗的原因,作為引數傳遞出去(供then方法的失敗回撥接收)

const promise = new Promise(function(resolve, reject){

	if(/*非同步操作成*/){
		resolve(value); // 成功時呼叫它會將Promise的狀態從"pending"變為"resolved"
	}else{
		reject(err);    // 失敗時呼叫它會將Promise的狀態從"pending"變為"rejected"
	}
});

複製程式碼

  • Promise例項生成後,可以用then方法分別指定resolved(引數是成功的結果)狀態和rejected(引數是失敗的原因)狀態的回撥函式; 即then方法接收兩個回撥函式作為引數:

    1 第一個函式,是Promise物件的狀態變為resolved時呼叫(接收成功的結果作為引數)

    2 第二個函式,是Promise物件的狀態變為rejected時呼叫可選

promise.then((value)=>{
	// value是成功的結果
}, (err)=>{
	// 失敗的原因
});

// 示例: demo/1.建立promise例項.js

複製程式碼
  • Promise的狀態發生改變時就會觸發then方法對應的不同狀態的函式引數

二、Promise新建後會立即執行

  • Promise是同步的,promise.then方法是非同步的
const promise = new Promise((resolve, reject)=>{
	
	console.log('Promise');
	resolve()；
});

promise.then((value)=>{
    console.log('Success')
});

console.log('Hi!');
// => Promie  Hi! Success
// 上面程式碼,Promise新建後會立即執行,所以會先輸出'Promise', 然後我們為then方法指定了回撥函式,因為then方法是非同步的,所以它會等待同步程式碼都執行完之後才執行，所以接下來輸出的是'Hi!',當主棧中的同步程式碼執行完畢之後, 開始執行非同步任務(then是個微任務), 因此promise狀態改變後成功的回撥輸出'Success'

// 示例: demo/2.promise建立會立即執行

複製程式碼
// 非同步載入圖片示例
function loadImageAsync(url){
    return new Promise((resolve, reject) => {
        let image = new Image();

        image.onload = function(){
            resolve(image);  // 如果圖片載入成則呼叫該方法, 將promise的狀態改為resolved
        };

        image.onerror = function(){
            reject('建立失敗'); // 如果圖片載入失敗, 則呼叫該方法, 將promise的狀態改為rejected
        };

        image.src = url;
    });
}

loadImageAsync('./timg2.jpg').then((value)=>{
    // 如果狀態變為成功態,則將圖片新增到頁面
    console.log(value);
    document.querySelector('body').appendChild(value);
}, (err)=>{
    // 狀態變為失敗態,則將提示錯誤
    console.log('Error:', err);
});


// 示例: demo/3.非同步載入圖片

複製程式碼
// Promise物件實現Ajax示例
let getJSON = function(){
    return new Promise((resolve, reject)=>{
        $.getJSON('./test.json').then((value)=>{
            console.log(value);
            resolve(value)
        }, (err)=>{
            // console.log('失敗回撥:',err)
            reject(err);
        });  
    });

};
getJSON().then((data)=>{
    console.log(data)
},(err)=>{
    console.log('My-Error:', err);
});

// 如果呼叫resolve函式和reject函式時帶有引數,那麼它們的引數被被傳遞給回撥函式(then的成功回撥和失敗回撥)


複製程式碼
  • Promise的回撥函式中丟擲錯誤或異常,則直接呼叫then的失敗態(reject)回撥函式
new Promise((resolve,reject)=>{
    throw new Error('錯誤');
}).then((data)=>{
    console.log(data)
},(err) => {
    console.log('Err ', err);  //Err  Error: 錯誤....
    return err;
})

複製程式碼

三、resolve函式返回Promise例項

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的狀態就會傳遞給p2，也就是說，p1的狀態決定了p2的狀態。如果p1的狀態是pending，那麼p2的回撥函式就會等待p1的狀態改變；如果p1的狀態已經是resolved或者rejected，那麼p2的回撥函式將會立刻執行
複製程式碼
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 秒之後變為rejected。p2的狀態在 1 秒之後改變，resolve方法返回的是p1。由於p2返回的是另一個 Promise，導致p2自己的狀態無效了，由p1的狀態決定p2的狀態。所以，後面的then語句都變成針對後者（p1）。又過了 2 秒，p1變為rejected，導致觸發catch方法指定的回撥函式



// 一言以蔽之: "傳遞的promise都要執行,直到執行後的結果是普通值(非promise)或丟擲異常, 再傳遞到下一個then中, 執行對應的回撥"
複製程式碼

四、呼叫resolve與reject並不會終結Promise的引數函式(executor)執行

new Promise((resolve,reject)=>{
    resolve('success');
    console.log('Hello')
}).then(data=>{
    console.log(data)
});

// => 'Hello' 'success'
// 一般來說, 呼叫resolve和reject以後,Promise的使命就完成了,後續的操作應該放到then方法裡面,而不應該直接寫在resolve和reject的後面; 所以,最好在它們前面加上return語句;
複製程式碼
new Promise((resolve,reject)=>{
    return resolve('success');
    console.log('Hello')
}).then(data=>{
    console.log(data)
});
// 此時只輸出success

複製程式碼

五、Promise.prototype.then()

  • Promise例項具有then方法,也就是說,then方法是定義在原型物件Promise.prototype上的;
  • then方法的作用是為Promise例項新增狀態改變時的回撥函式,它的第一個引數是resolve狀態的回撥函式,第二個引數是rejected狀態的回撥函式;
  • then方法返回的是一個新的Promise例項(注意不是原來那個Promise例項);
  • 鏈式寫法,即then方法後面再呼叫另一個then方法

1、 then鏈式呼叫, 第一個then回撥的返回結果會作為第二個then回撥的引數

new Promise((resolve,reject)=>{
    return resolve('success');   	// 將狀態改變為成功態
}).then((data)=>{
    console.log(data)				// success
    return '成功' + data;
},(err) => {
    console.log('Err', err);
    return err;
}).then((data) => {
    console.log(data)				// 成功success
}, (err) =>{
    console.log("Fail", err)
});

// 上面程式碼使用then方法, 依次執行兩個then的回撥函式. 第一個回撥完成後,會將返回結果作為引數,傳入到第二個回撥函式;
複製程式碼

2、 then的reject回撥函式中返回錯誤,會繼續傳遞到下一個then的成功(resolve)回撥 切記

new Promise((resolve,reject)=>{
    return reject('fail');  // 執行失敗回撥
}).then((data)=>{
    console.log(data); 		
    return '成功';
},(err) => {
    console.log('Err', err);  // Err fail
    return err;
}).then((data) => {
    console.log('hello',data) // hello fail
}, (err) =>{
    console.log("Fail", err)
});

複製程式碼

3、then()會多層傳遞

new Promise((resolve,reject)=>{
    resolve('ABC');
}).then().then().then((data)=>{
    console.log(data)
},(err)=>{
    console.log(err)
});
// 輸出 "ABC"
複製程式碼

六、Promise.prototype.catch()

  • Promise.prototype.catch方法是.then(null, rejection)的別名,用於指定發生錯誤時的回撥函式
new Promise((resolve,reject)=>{
    throw new Error('錯誤');
}).catch((err)=>{
	console.log('Error:', err); // Error: Error: 錯誤
});

等同於

new Promise((resolve,reject)=>{
    throw new Error('錯誤');
}).then(null, (err)=>{
	console.log('Error:', err); // Error: Error: 錯誤
});

複製程式碼
  • 在Promise的回撥函式中直接丟擲錯誤,此時狀態變為rejected, 錯誤會被catch捕獲
new Promise((resolve,reject)=>{
    throw new Error('錯誤');
}).catch((err)=>{
	console.log('Error:', err); // Error: Error: 錯誤
});

複製程式碼
  • then方法指定回撥函式, 在執行中丟擲錯誤, 也會被catch捕獲
new Promise((resolve,reject)=>{
    resolve('ABC');   	// 將狀態改變為成功態
}).then((data)=>{
    console.log(test)	// 在then的成功回撥中執行,輸出一個未定義的變數,此時會丟擲錯誤
},(err) => {
    console.log('Err ', err);
}).catch((err)=>{
    console.log('Catch ', err); // 在這裡被捕獲 => Catch  ReferenceError: test is not defined ....
});

複製程式碼
  • 如果Promise的狀態已經變成resolved, 再丟擲錯誤是無效的
new Promise((resolve,reject)=>{
    resolve('ABC');
    throw new Error('錯誤');
}).then((data)=>{
    console.log(data)  // 輸出ABC
},(err) => {
    console.log('Err ', err);
}).catch((err)=>{
    console.log('Catch ', err);
});

// 上面程式碼執行輸出了"ABC",說明在狀態改變後丟擲錯誤,對結果無影響
// 上面程式碼中,Promise在resolve語句後面丟擲錯誤,沒有被捕獲,相當於沒有丟擲錯誤;因為Promise的狀態一旦改變,就永遠保持該狀態,不會再變了;
複製程式碼
  • reject的作用等同於丟擲錯誤
new Promise((resolve,reject)=>{
    reject('ABC');
}).catch((err)=>{
    console.log('Catch ', err);
});
// 輸出: "Catch  ABC"

等同於
new Promise((resolve,reject)=>{
    try{
        console.log('a')
        throw new Error('test');
    }catch(e){
        console.log('b')
        reject(e)
    }
}).catch((err)=>{
    console.log('Catch ', err);
});
// => a b Catch  Error: test
複製程式碼

Promise.all()

  • Promise.all方法用於將多個Promise例項,包裝成一個新的Promise例項
  • Promise.all方法接受一個陣列作為引數(陣列中的每一項都是一個promise例項),只有所有的例項狀態都變為fulfilled, promise例項的狀態才會變成fulfilled, 此時陣列中promise例項的返回值會組成一個陣列,傳遞給該promise例項的回撥函式, 返回值在陣列中的順序與promise陣列中promise例項的順序一致
let p1 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(100);
    }, 2000);
});

let p2 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve('Hello');
    }, 3000);
});

let p3 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(true);
    }, 2000);
});

Promise.all([p1, p2, p3]).then((data)=>{
    console.log(data);  // 等陣列中的promise例項都執行完成後,才將狀態改變為fulfilled => [ 100, 'Hello', true ]
}, (err)=>{
    console.log(err)
});

// => [ 100, 'Hello', true ]
複製程式碼
  • 如果其中有一個promise例項丟擲錯誤,就會走到Promise.all().catch()方法
let p1 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(100);
    }, 2000);
});

let p2 = new Promise((resolve,reject)=>{
    throw Error('錯誤啦');
});


let p3 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(true);
    }, 2000);
});

Promise.all([p1, p2, p3]).then((data)=>{
    console.log(data)
}).catch(err=>{
    console.log('Promise.all Error:', err)
});

// => Promise.all Error: Error: 錯誤啦....
// 在p2執行時丟擲了異常,那麼整個Promise.all()執行狀態被改變為rejected, 錯誤被catch捕獲

複製程式碼
  • 如果作為引數的Promise例項,自己定義了catch方法, 那麼一旦被rejected,並不會觸發Promise.all()的catch方法
let p1 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(100);
    }, 2000);
});

let p2 = new Promise((resolve,reject)=>{
    throw Error('錯誤啦');
}).catch(err=>{
    console.log('p2.Error', err);		// p2.Error Error: 錯誤啦
});

Promise.all([p1, p2]).then((data)=>{
    console.log(data);					// [ 100, undefined ]
}).catch(err=>{
    console.log('Promise.all Error:', err)
});

// 上例中,p1在2秒後狀態改變為resolve； p2執行時丟擲錯誤,此時p2的狀態改變為rejected, 因為它有自己的catch,在執行完catch方法後,狀態也變成了resolve, 因此會呼叫then的指定的回撥, 而不會呼叫catch方法指定的回撥函式; 所以,最終列印出: [ 100, undefined ]
複製程式碼

Promise.race()

  • Promise.race方法同樣是將多個Promise例項,包裝成一個新的Promise例項
  • 同上面all()方法相比,只要有一個例項率先改變狀態,整個promise例項的狀態就跟隨改變; 與此同時,第一個改變的promise例項(陣列中的)的值,被傳遞給Promise的回撥函式
let p1 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(100);
    }, 2000);
});

let p3 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(true);
    }, 2500);
});

Promise.race([p1,  p3]).then((data)=>{
    console.log(data)		// 100
}).catch(err=>{
    console.log('Promise.all Error:', err)
});
複製程式碼
  • 如果promise陣列中有一個普通值,會立馬返回
let p1 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(100);
    }, 2000);
});

let p3 = new Promise((resolve,reject)=>{
    setTimeout(() => {
        resolve(true);
    }, 2500);
});

Promise.race([p1,  p3, 10086]).then((data)=>{
    console.log(data)	// 10086
}).catch(err=>{
    console.log('Promise.all Error:', err)
});

// => 10086; 因為我們最終要使用的是普通值或普通物件,而非promsie,所有的例項最終的目的都是要返回普通值, 因此遇到普通值會立馬返回
複製程式碼

Promise.resolve()

  • Promise.resolve()可用於將現有物件轉換為Promise物件

  • Promise.resolve('foo') 等價於new Promise(resolve=>resolve('foo'))

  • Promise.resolve方法的引數分成四種情況: 1、引數是一個 Promise 例項

    • 如果引數是 Promise 例項，那麼Promise.resolve將不做任何修改、原封不動地返回這個例項

    2、引數是一個thenable物件(thenable物件指的是具有then方法的物件)

    • Promise.resolve方法會將這個物件轉為 Promise 物件，然後就立即執行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方法執行後，物件p1的狀態就變為resolved，從而立即執行最後那個then方法指定的回撥函式，輸出 42	

複製程式碼

    3、引數不是具有then方法的物件,或根本就不是物件

    • 如果引數是一個原始值,或者是一個不具有then方法的物件,則Promise.resolve方法返回一個新的 Promise物件,狀態為resolved
    const p = Promise.resolve('Hello');
p.then(function (s){
  console.log(s)
});
// Hello
// 上面程式碼生成一個新的 Promise 物件的例項p。由於字串Hello不屬於非同步操作（判斷方法是字串物件不具有 then 方法），返回 Promise 例項的狀態從一生成就是resolved，所以回撥函式會立即執行。Promise.resolve方法的引數，會同時傳給回撥函式
複製程式碼

    4、不帶有任何引數

    • Promise.resolve方法允許呼叫時不帶引數,直接返回一個resolved狀態的Promise物件,所以,如果希望得到一個Promise物件,比較方便的方法就是直接呼叫Promise.resolve方法

Promise.reject()

  • Promise.reject(reason)方法也會返回一個新的 Promise 例項，該例項的狀態為rejected
const p = Promise.reject('出錯了');
// 等同於
const p = new Promise((resolve, reject) => reject('出錯了'))

p.then(null, function (s) {
  console.log(s)
});
// 出錯了
//上面程式碼生成一個Promise物件的例項p,狀態為rejected,回撥函式會立即執行
複製程式碼
  • Promise.reject()方法的引數,會原封不動地作為reject的理由,變成後續方法的引數.這一點與Promise.resolve方法不一致
const thenable = {
  then(resolve, reject) {
    reject('出錯了');
  }
};

Promise.reject(thenable)
.catch(e => {
  console.log(e === thenable)
})
// true
// 上面程式碼中,Promise.reject方法的引數是一個thenable物件,執行以後,後面catch方法的引數不是reject丟擲的"出錯了"這個字串,而是thenable物件
複製程式碼

參考文件

ECMAScript 6 入門 - Promise物件

相關文章