Cody Di Da Di

搭拉拉拉搭搭搭

0%

每天一點點，學習ES6-八-Promise 實例

發表於 分類於 ， 6.7k 6 分鐘

前言

昨天研究完原理 及 一點點低基礎 還有流程

趁著記憶猶新 來看看實際用法

推眼鏡

Promise 實例

Promise的 then 、 catch 、 finally 方法，

都屬於Promise的實例方法，都是存放在 Promise 的 prototype 上的

1
console.log(Object.getOwnPropertyDescriptors(Promise.prototype))

promise實例方法

以上是F12 看到的實例方法

then()

then是實例狀態發生改變時的回調函數，

  • 第一個參數是resolved狀態的回調函數
  • 第二個參數是rejected狀態的回調函數

then方法返回的是一個 新的Promise實例，也就是promise能 鍊式書寫 的原因

1
2
3
4
5
getJSON("/posts.json").then(function(json) {
  return json.post;
}).then(function(post) {
  // ...
});

catch()

catch()方法是 .then(null, rejection)或.then(undefined, rejection)的別名，

用於指定發生錯誤時的回調函數

1
2
3
4
5
6
getJSON('/posts.json').then(function(posts) {
  // ...
}).catch(function(error) {
  // 處理 getJSON 和 前一個回調函數運行時發生的錯誤
  console.log('发生错误！', error);
});

Promise對象的錯誤具有“冒泡”性質，會一直向後傳遞，直到被捕獲為止

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

一般來說，使用catch方法代替then()第二個參數

Promise對象拋出的錯誤不會傳遞到外層代碼，即不會有任何反應

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

瀏覽器運行到這一行，
會打印出錯誤提示ReferenceError: x is not defined，
但是不會退出進程

catch()方法之中，還能再拋出錯誤，通過後面catch方法捕獲到

再舉個例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const promise = new Promise((resolve, reject) => {
  reject("111111")
})

promise.catch(err => {
  console.log("err1:", err)
}).catch(err2 => {
  console.log("err2:", err2)
}).then(res => {
  console.log("res result:", res)
})
// err1: 111111
// res result: undefined

如果希望後續能夠執行 catch ，那麼需要拋出一個異常

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
const promise = new Promise((resolve, reject) => {
  reject("111111")
})

promise.then(res => {
  console.log("res:", res)
}).catch(err => {
  console.log("err:", err)
  throw new Error("catch return value")
}).then(res => {
  console.log("res result:", res)
}).catch(err => {
  console.log("err result:", err)
})

// err: 111111
// err result: Error: catch return value

finally()

finally()方法用於指定不管Promise 對象最後狀態如何，都會執行的操作

1
2
3
4
promise
.then(result => {···})
.catch(error => {···})
.finally(() => {···});

Promise API 也稱構造函數方法

總共有以下的方法：

Promise API
all() Promise.all()方法用於將多個 Promise實例，包裝成一個新的 Promise實例
race() Promise.race()方法同樣是將多個Promise 實例，包裝成一個新的Promise 實例
allSettled() Promise.allSettled()方法接受一組Promise 實例作為參數，包裝成一個新的Promise 實例
只有等到所有這些參數實例都返回結果，不管是fulfilled還是rejected，包裝實例才會結束
resolve() Promise.resolve()將現有對象轉為 Promise對象
reject() Promise.reject(reason)方法也會返回一個新的Promise 實例，該實例的狀態為rejected

all()

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

接受一個數組Array（疊代對象）作為參數，數組成員都應為Promise實例

實例p的狀態由p1、p2、p3決定，分為兩種：

  • 只有p1、p2、p3的狀態都變成fulfilled，p的狀態才會變成fulfilled，此時p1、p2、p3的返回值組成一個數組，傳遞給p的回調函數
  • 只要p1、p2、p3之中有一個被rejected，p的狀態就變成rejected，此時第一個被reject的實例的返回值，會傳遞給p的回調函數

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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: 報錯囉]

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const p1 = new Promise((resolve, reject) => {
  resolve('hello');
})
.then(result => result);

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

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

race()

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

只要p1、p2、p3之中有一個實例率先改變狀態，p的狀態就跟著改變

率先改變的Promise 實例的返回值則傳遞給p的回調函數

1
2
3
4
5
6
7
8
9
10
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(console.log)
.catch(console.error);

allSettled()

1
2
3
4
5
6
7
8
const promises = [
  fetch('/api-1'),
  fetch('/api-2'),
  fetch('/api-3'),
];

await Promise.allSettled(promises);
removeLoadingIndicator();

resolve()

1
2
3
Promise.resolve('foo')
// 等於
new Promise(resolve => resolve('foo'))

參數可以分成四種情況，分別如下：

  • 參數是一個Promise 實例，promise.resolve將不做任何修改、原封不動地返回這個實例
  • 參數是一個thenable對象，promise.resolve會將這個對象轉為 Promise對象，然後就立即執行thenable對象的then()方法
  • 參數不是具有then()方法的對象，或根本就不是對象，Promise.resolve()會返回一個新的Promise 對象，狀態為resolved
  • 沒有參數時，直接返回一個resolved狀態的Promise 對象

reject()

1
2
3
4
5
6
7
8
const p = Promise.reject('出錯了');
// 等於
const p = new Promise((resolve, reject) => reject('出錯了'))

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

Promise.reject()方法的參數，會原封不動地變成後續方法的參數

1
2
3
4
5
Promise.reject('出錯了')
.catch(e => {
  console.log(e === '出錯了')
})
// true

使用場景

將圖片的加載寫成一個Promise，一旦加載完成，Promise的狀態就發生變化

1
2
3
4
5
6
7
8
const preloadImage = function (path) {
  return new Promise(function (resolve, reject) {
    const image = new Image();
    image.onload  = resolve;
    image.onerror = reject;
    image.src = path;
  });
};

通過鍊式操作，將多個渲染數據分別給個then，讓其各司其職。
或當下個異步請求依賴上個請求結果的時候，我們也能夠通過鍊式操作友好解決問題!!

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 各自做各自的事
getInfo().then(res=>{
    let { bannerList } = res
    //渲染輪播圖
    console.log(bannerList)
    return res
}).then(res=>{
    
    let { storeList } = res
    //渲染店鋪列表
    console.log(storeList)
    return res
}).then(res=>{
    let { categoryList } = res
    console.log(categoryList)
    //渲染分類列表
    return res
})

通過all()實現多個請求合併在一起，匯總所有請求結果，只需設置一個loading即可

1
2
3
4
5
6
7
8
9
10
11
12
function initLoad(){
    // loading.show() //加载loading
    Promise.all([getBannerList(),getStoreList(),getCategoryList()]).then(res=>{
        console.log(res)
        loading.hide() //關閉loading
    }).catch(err=>{
        console.log(err)
        loading.hide()//關閉loading
    })
}
//數據初始化    
initLoad();

通過race()可以設置圖片請求超時

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
//請求圖片資源
function requestImg(){
    var p = new Promise(function(resolve, reject){
        var img = new Image();
        img.onload = function(){
           resolve(img);
        }
        //img.src = "https://b-gold-cdn.xitu.io/v3/static/img/logo.a7995ad.svg"; 正確的
        img.src = "https://b-gold-cdn.xitu.io/v3/static/img/logo.a7995ad.svg1";
    });
    return p;
}

//延時函數，用來給請求計時
function timeout(){
    var p = new Promise(function(resolve, reject){
        setTimeout(function(){
            reject('圖片請求超時');
        }, 5000);
    });
    return p;
}

Promise
.race([requestImg(), timeout()])
.then(function(results){
    console.log(results);
})
.catch(function(reason){
    console.log(reason);
});

看了那麼多網頁，終於有一點點點點理解了

ya

References

你的支持是我活力的來源 :)