Promise基礎用法

時間 2019-12-06

標籤 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應用(前一個函數的執行結果做爲下一個函數的參數),就面臨着大量的回調函數的窘境,回調函數的多層嵌套成爲咱們繞不開的噩夢;es6

爲解決回調而生

Promise對象,能夠將異步操做以同步的流程表達出來,避免了層層嵌套的回調函數;
Promise對象提供統一的接口,使得控制異步更加容易;

不是最perfect, 由於它仍是基於回調

沒法取消Promise,一旦新建就會當即執行,沒法中途取消;
若是不設置回調函數,Promise內部拋出的錯誤,不會反應到外部;
當處於pending時,沒法得知目前進展到哪個階段(剛剛開始仍是即將完成)
從本質上來講,Promise仍是基於回調的

基礎用法

1、構造函數與then

ES6規定,Promise對象是一個構造函數,用來生成Promise實例ajax
Promise接收一個函數(executor:執行者)做爲參數,該函數有兩個參數:編程

1 resolve(Function) -> 將Promise對象的狀態從"未完成pending"變爲"成功resolved",在異步操做成時調用,並將異步操做的結果,做爲參數傳遞出去(供then方法的成功回調接收)json

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方法接收兩個回調函數做爲參數:promise

1 第一個函數,是Promise對象的狀態變爲resolved時調用(接收成功的結果做爲參數)瀏覽器

2 第二個函數,是Promise對象的狀態變爲rejected時調用可選bash

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

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

複製代碼

Promise的狀態發生改變時就會觸發then方法對應的不一樣狀態的函數參數

2、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;
})

複製代碼

3、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中, 執行對應的回調"
複製代碼

4、調用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

複製代碼

5、Promise.prototype.then()

Promise實例具備then方法,也就是說,then方法是定義在原型對象Promise.prototype上的;
then方法的做用是爲Promise實例添加狀態改變時的回調函數,它的第一個參數是resolve狀態的回調函數,第二個參數是rejected狀態的回調函數;
then方法返回的是一個新的Promise實例(注意不是原來那個Promise實例);
鏈式寫法,即then方法後面再調用另外一個then方法

一、 then鏈式調用, 第一個then回調的返回結果會做爲第二個then回調的參數app

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的回調函數. 第一個回調完成後,會將返回結果做爲參數,傳入到第二個回調函數;
複製代碼

二、 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)
});

複製代碼

三、then()會多層傳遞

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

6、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方法的參數分紅四種狀況: 一、參數是一個 Promise 實例
- 若是參數是 Promise 實例，那麼Promise.resolve將不作任何修改、原封不動地返回這個實例
二、參數是一個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	

複製代碼
```
三、參數不是具備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方法的參數，會同時傳給回調函數
複製代碼
```
四、不帶有任何參數
- 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對象
複製代碼