当前位置：移动技术网 > IT编程>开发语言>JavaScript > Promise入门详解和基本用法

Promise入门详解和基本用法

2020年04月08日 | 移动技术网IT编程 | 我要评论

异步调用

异步

javascript的执行环境是单线程。

所谓单线程，是指js引擎中负责解释和执行javascript代码的线程只有一个，也就是一次只能完成一项任务，这个任务执行完后才能执行下一个，它会「阻塞」其他任务。这个任务可称为主线程。

异步模式可以一起执行多个任务。

常见的异步模式有以下几种：

定时器
接口调用
事件函数

今天这篇文章，我们重点讲一下接口调用。接口调用里，重点讲一下promise。

接口调用的方式

js 中常见的接口调用方式，有以下几种：

原生ajax
基于jquery的ajax
fetch
promise
axios

多次异步调用的依赖分析

多次异步调用的结果，顺序可能不同步。
异步调用的结果如果存在依赖，则需要嵌套。

在es5中，当进行多层嵌套回调时，会导致代码层次过多，很难进行维护和二次开发；而且会导致回调地狱的问题。es6中的promise 就可以解决这两个问题。

promise 概述

promise的介绍和优点

es6中的promise 是异步编程的一种方案。从语法上讲，promise 是一个对象，它可以获取异步操作的消息。

promise对象, 可以将异步操作以同步的流程表达出来。使用 promise 主要有以下好处：

可以很好地解决回调地狱的问题（避免了层层嵌套的回调函数）。
语法非常简洁。promise 对象提供了简洁的api，使得控制异步操作更加容易。

回调地狱的举例

假设买菜、做饭、洗碗都是异步的。

但真实的场景中，实际的操作流程是：买菜成功之后，才能开始做饭。做饭成功后，才能开始洗碗。这里面就涉及到了多层嵌套调用，也就是回调地狱。

promise 的基本用法

（1）使用new实例化一个promise对象，promise的构造函数中传递一个参数。这个参数是一个函数，该函数用于处理异步任务。

（2）并且传入两个参数：resolve和reject，分别表示异步执行成功后的回调函数和异步执行失败后的回调函数；

（3）通过 promise.then() 处理返回结果。这里的 p 指的是 promise实例。

代码举例如下：

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script>
            // 第一步：model层的接口封装
            const promise = new promise((resolve, reject) => {
                // 这里做异步任务（比如ajax 请求接口。这里暂时用定时器代替）
                settimeout(function() {
                    var data = { retcode: 0, msg: 'qianguyihao' }; // 接口返回的数据
                    if (data.retcode == 0) {
                        // 接口请求成功时调用
                        resolve(data);
                    } else {
                        // 接口请求失败时调用
                        reject({ retcode: -1, msg: 'network error' });
                    }
                }, 100);
            });

            // 第二步：业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的，也就是从接口拿到的数据
            promise.then(data => {
                // 从 resolve 获取正常结果
                console.log(data);
            }).catch(data => {
                // 从 reject 获取异常结果
                console.log(data);
            });
        </script>
    </body>
</html>

上方代码中，当从接口返回的数据data.retcode的值不同时，可能会走 resolve，也可能会走 reject，这个由你自己的业务决定。

promise对象的3个状态（了解即可）

初始化状态（等待状态）：pending
成功状态：fullfilled
失败状态：rejected

（1）当new promise()执行之后，promise对象的状态会被初始化为pending，这个状态是初始化状态。new promise()这行代码，括号里的内容是同步执行的。括号里定义一个function，function有两个参数：resolve和reject。如下：

如果请求成功了，则执行resolve()，此时，promise的状态会被自动修改为fullfilled。
如果请求失败了，则执行reject()，此时，promise的状态会被自动修改为rejected

（2）promise.then()方法，括号里面有两个参数，分别代表两个函数 function1 和 function2：

如果promise的状态为fullfilled（意思是：如果请求成功），则执行function1里的内容
如果promise的状态为rejected（意思是，如果请求失败），则执行function2里的内容

另外，resolve()和reject()这两个方法，是可以给promise.then()传递参数的。

完整代码举例如下：

    let promise = new promise((resolve, reject) => {
        //进来之后，状态为pending
        console.log('111');  //这行代码是同步的
        //开始执行异步操作（这里开始，写异步的代码，比如ajax请求 or 开启定时器）
        if (异步的ajax请求成功) {
            console.log('333');
            resolve('haha');//如果请求成功了，请写resolve()，此时，promise的状态会被自动修改为fullfilled
        } else {
            reject('555');//如果请求失败了，请写reject()，此时，promise的状态会被自动修改为rejected
        }
    })
    console.log('222');

    //调用promise的then()
    promise.then((successmsg) => {
            //如果promise的状态为fullfilled，则执行这里的代码
            console.log(successmsg, '成功了');
        }
        , (errormsg) => {
            //如果promise的状态为rejected，则执行这里的代码
            console.log(errormsg, '失败了');

        }
    )

基于 promise 处理多次 ajax 请求（链式调用）【重要】

实际开发中，我们经常需要同时请求多个接口。比如说：在请求完接口1的数据data1之后，需要根据data1的数据，继续请求接口2，获取data2；然后根据data2的数据，继续请求接口3。

这种场景其实就是接口的多层嵌套调用。有了 promise之后，我们可以把多层嵌套调用按照线性的方式进行书写，非常优雅。

也就是说：promise 可以把原本的多层嵌套调用改进为链式调用。

代码举例：（多次 ajax请求，链式调用）

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script type="text/javascript">
            /*
              基于promise发送ajax请求
            */
            function querydata(url) {
                var promise = new promise((resolve, reject) => {
                    var xhr = new xmlhttprequest();
                    xhr.onreadystatechange = function() {
                        if (xhr.readystate != 4) return;
                        if (xhr.readystate == 4 && xhr.status == 200) {
                            // 处理正常情况
                            resolve(xhr.responsetext); // xhr.responsetext 是从接口拿到的数据
                        } else {
                            // 处理异常情况
                            reject('接口请求失败');
                        }
                    };
                    xhr.responsetype = 'json'; // 设置返回的数据类型
                    xhr.open('get', url);
                    xhr.send(null); // 请求接口
                });
                return promise;
            }
            // 发送多个ajax请求并且保证顺序
            querydata('http://localhost:3000/api1')
                .then(
                    data1 => {
                        console.log(json.stringify(data1));
                        // 请求完接口1后，继续请求接口2
                        return querydata('http://localhost:3000/api2');
                    },
                    error1 => {
                        console.log(error1);
                    }
                )
                .then(
                    data2 => {
                        console.log(json.stringify(data2));
                        // 请求完接口2后，继续请求接口3
                        return querydata('http://localhost:3000/api3');
                    },
                    error2 => {
                        console.log(error2);
                    }
                )
                .then(
                    data3 => {
                        // 获取接口3返回的数据
                        console.log(json.stringify(data3));
                    },
                    error3 => {
                        console.log(error3);
                    }
                );
        </script>
    </body>
</html>

上面这个举例很经典，需要多看几遍。

return 的函数返回值

return 后面的返回值，有两种情况：

情况1：返回 promise 实例对象。返回的该实例对象会调用下一个 then。
情况2：返回普通值。返回的普通值会直接传递给下一个then，通过 then 参数中函数的参数接收该值。

我们针对上面这两种情况，详细解释一下。

情况1：返回 promise 实例对象

举例如下：（这个例子，跟上一段 ajax 链式调用的例子差不多）

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script type="text/javascript">
            /*
              基于promise发送ajax请求
            */
            function querydata(url) {
                return new promise((resolve, reject) => {
                    var xhr = new xmlhttprequest();
                    xhr.onreadystatechange = function() {
                        if (xhr.readystate != 4) return;
                        if (xhr.readystate == 4 && xhr.status == 200) {
                            // 处理正常情况
                            resolve(xhr.responsetext);
                        } else {
                            // 处理异常情况
                            reject('接口请求失败');
                        }
                    };
                    xhr.responsetype = 'json'; // 设置返回的数据类型
                    xhr.open('get', url);
                    xhr.send(null); // 请求接口
                });
            }
            // 发送多个ajax请求并且保证顺序
            querydata('http://localhost:3000/api1')
                .then(
                    data1 => {
                        console.log(json.stringify(data1));
                        return querydata('http://localhost:3000/api2');
                    },
                    error1 => {
                        console.log(error1);
                    }
                )
                .then(
                    data2 => {
                        console.log(json.stringify(data2));
                        // 这里的 return，返回的是 promise 实例对象
                        return new promise((resolve, reject) => {
                            resolve('qianguyihao');
                        });
                    },
                    error2 => {
                        console.log(error2);
                    }
                )
                .then(data3 => {
                    console.log(data3);
                });
        </script>
    </body>
</html>

情况2：返回普通值

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script type="text/javascript">
            /*
              基于promise发送ajax请求
            */
            function querydata(url) {
                return new promise((resolve, reject) => {
                    var xhr = new xmlhttprequest();
                    xhr.onreadystatechange = function() {
                        if (xhr.readystate != 4) return;
                        if (xhr.readystate == 4 && xhr.status == 200) {
                            // 处理正常情况
                            resolve(xhr.responsetext);
                        } else {
                            // 处理异常情况
                            reject('接口请求失败');
                        }
                    };
                    xhr.responsetype = 'json'; // 设置返回的数据类型
                    xhr.open('get', url);
                    xhr.send(null); // 请求接口
                });
            }
            // 发送多个ajax请求并且保证顺序
            querydata('http://localhost:3000/api1')
                .then(
                    data1 => {
                        console.log(json.stringify(data1));
                        return querydata('http://localhost:3000/api2');
                    },
                    error1 => {
                        console.log(error1);
                    }
                )
                .then(
                    data2 => {
                        console.log(json.stringify(data2));
                        // 返回普通值
                        return 'qianguyihao';
                    },
                    error2 => {
                        console.log(error2);
                    }
                )
                /*
                    既然上方返回的是 普通值，那么，这里的 then 是谁来调用呢？
                    答案是：这里会产生一个新的 默认的 promise实例，来调用这里的then，确保可以继续进行链式操作。
                */
                .then(data3 => {
                    // 这里的 data3 接收的是 普通值 'qianguyihao'
                    console.log(data3);
                });
        </script>
    </body>
</html>

promise 的常用api：实例方法【重要】

promise 自带的api提供了如下实例方法：

promise.then()：获取异步任务的正常结果。
promise.catch()：获取异步任务的异常结果。
promise.finaly()：异步任务无论成功与否，都会执行。

代码举例如下。

写法1：

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script>
            function querydata() {
                return new promise((resolve, reject) => {
                    settimeout(function() {
                        var data = { retcode: 0, msg: 'qianguyihao' }; // 接口返回的数据
                        if (data.retcode == 0) {
                            // 接口请求成功时调用
                            resolve(data);
                        } else {
                            // 接口请求失败时调用
                            reject({ retcode: -1, msg: 'network error' });
                        }
                    }, 100);
                });
            }

            querydata()
                .then(data => {
                    // 从 resolve 获取正常结果
                    console.log('接口请求成功时，走这里');
                    console.log(data);
                })
                .catch(data => {
                    // 从 reject 获取异常结果
                    console.log('接口请求失败时，走这里');
                    console.log(data);
                })
                .finally(() => {
                    console.log('无论接口请求成功与否，都会走这里');
                });
        </script>
    </body>
</html>

写法2：（和上面的写法1等价）

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script>
            function querydata() {
                return new promise((resolve, reject) => {
                    settimeout(function() {
                        var data = { retcode: 0, msg: 'qianguyihao' }; // 接口返回的数据
                        if (data.retcode == 0) {
                            // 接口请求成功时调用
                            resolve(data);
                        } else {
                            // 接口请求失败时调用
                            reject({ retcode: -1, msg: 'network error' });
                        }
                    }, 100);
                });
            }

            querydata()
                .then(
                    data => {
                        // 从 resolve 获取正常结果
                        console.log('接口请求成功时，走这里');
                        console.log(data);
                    },
                    data => {
                        // 从 reject 获取异常结果
                        console.log('接口请求失败时，走这里');
                        console.log(data);
                    }
                )
                .finally(() => {
                    console.log('无论接口请求成功与否，都会走这里');
                });
        </script>
    </body>
</html>

注意：写法1和写法2的作用是完全等价的。只不过，写法2是把 catch 里面的代码作为 then里面的第二个参数而已。

promise 的常用api：对象方法【重要】

promise 自带的api提供了如下对象方法：

promise.all()：并发处理多个异步任务，所有任务都执行成功，才能得到结果。
promise.race(): 并发处理多个异步任务，只要有一个任务执行成功，就能得到结果。

下面来详细介绍。

promise.all() 代码举例

代码举例：

<!doctype html>
<html lang="en">
    <head>
        <meta charset="utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>document</title>
    </head>
    <body>
        <script type="text/javascript">
            /*
              封装 promise 接口调用
            */
            function querydata(url) {
                return new promise((resolve, reject) => {
                    var xhr = new xmlhttprequest();
                    xhr.onreadystatechange = function() {
                        if (xhr.readystate != 4) return;
                        if (xhr.readystate == 4 && xhr.status == 200) {
                            // 处理正常结果
                            resolve(xhr.responsetext);
                        } else {
                            // 处理异常结果
                            reject('服务器错误');
                        }
                    };
                    xhr.open('get', url);
                    xhr.send(null);
                });
            }

            var promise1 = querydata('http://localhost:3000/a1');
            var promise2 = querydata('http://localhost:3000/a2');
            var promise3 = querydata('http://localhost:3000/a3');

            promise.all([promise1, promise2, promise3]).then(result => {
                console.log(result);
            });
        </script>
    </body>
</html>

promise.race() 代码举例