promise-api · uni-app跨平台移动应用开发

# Promise API 在`Promise`类中，有 4 中静态方法。我们在这里做下简单介绍。 ## [](https://github.com/javascript-tutorial/zh.javascript.info/blob/master/1-js/11-async/04-promise-api/article.md#promiseresolve)Promise.resolve 语法： ~~~js let promise = Promise.resolve(value); ~~~ 根据给定的`value`值返回 resolved promise。等价于： ~~~js let promise = new Promise(resolve => resolve(value)); ~~~ 当我们已经有一个 value 的时候，就会使用该方法，但希望将它“封装”进 promise。例如，下面的`loadCached`函数会获取`url`并记住结果，以便以后对同一 URL 进行调用时可以立即返回： ~~~js function loadCached(url) { let cache = loadCached.cache || (loadCached.cache = new Map()); if (cache.has(url)) { *!* return Promise.resolve(cache.get(url)); // (*) */!* } return fetch(url) .then(response => response.text()) .then(text => { cache[url] = text; return text; }); } ~~~ 我们可以使用`loadCached(url).then(…)`，因为函数保证会返回一个 promise。这是`Promise.resolve`在`(*)`行的目的：它确保了接口的统一性。我们可以在`loadCached`之后使用`.then`。 ## [](https://github.com/javascript-tutorial/zh.javascript.info/blob/master/1-js/11-async/04-promise-api/article.md#promisereject)Promise.reject 语法： ~~~js let promise = Promise.reject(error); ~~~ 创建一个带有`error`的 rejected promise。就像这样： ~~~js let promise = new Promise((resolve, reject) => reject(error)); ~~~ 我们会在此讨论它的完整性，但在实际工作中，我们很少这样使用。 ## [](https://github.com/javascript-tutorial/zh.javascript.info/blob/master/1-js/11-async/04-promise-api/article.md#promiseall)Promise.all 该方法并行运行多个 promise，并等待所有 promise 准备就绪。语法： ~~~js let promise = Promise.all(iterable); ~~~ 它需要一个带有 promise 的`iterable`对象，技术上来说，它是可以迭代的，但通常情况下，它只是一个数组，而且会返回一个新的 promise。新的 promise 是在所有 promise 都被解决并拥有一个存放结果的数组之后才出现的。例如，下面的`Promise.all`在 3 秒之后被处理，然后它的结果就是一个`[1, 2, 3]`数组： ~~~js Promise.all([ new Promise((resolve, reject) => setTimeout(() => resolve(1), 3000)), // 1 new Promise((resolve, reject) => setTimeout(() => resolve(2), 2000)), // 2 new Promise((resolve, reject) => setTimeout(() => resolve(3), 1000)) // 3 ]).then(alert); // 1,2,3 when promises are ready: each promise contributes an array member ~~~ 注意，它们的相对顺序是相同的。尽管第一个 promise 需要很长的时间来解决，但它仍然是结果数组中的第一个。常见技巧是将一组作业数据映射到一个 promise 数组，然后再将它们封装进`Promise.all`。例如，我们有一个存储 URL 的数组，我们就可以像这样来获取它们： ~~~js let urls = [ 'https://api.github.com/users/iliakan', 'https://api.github.com/users/remy', 'https://api.github.com/users/jeresig' ]; // map every url to the promise fetch(github url) let requests = urls.map(url => fetch(url)); // Promise.all waits until all jobs are resolved Promise.all(requests) .then(responses => responses.forEach( response => alert(`${response.url}: ${response.status}`) )); ~~~ 一个更真实的示例是通过用户名来为 GitHub 用户数组获取用户信息（或者我们可以通过他们的 id 来获取一系列商品，逻辑都是一样的）： ~~~js let names = ['iliakan', 'remy', 'jeresig']; let requests = names.map(name => fetch(`https://api.github.com/users/${name}`)); Promise.all(requests) .then(responses => { // all responses are ready, we can show HTTP status codes for(let response of responses) { alert(`${response.url}: ${response.status}`); // shows 200 for every url } return responses; }) // map array of responses into array of response.json() to read their content .then(responses => Promise.all(responses.map(r => r.json()))) // all JSON answers are parsed: "users" is the array of them .then(users => users.forEach(user => alert(user.name))); ~~~ 如果任何 promise 为 rejected，`Promise.all`就会立即以 error reject。例如： ~~~js Promise.all([ new Promise((resolve, reject) => setTimeout(() => resolve(1), 1000)), *!* new Promise((resolve, reject) => setTimeout(() => reject(new Error("Whoops!")), 2000)), */!* new Promise((resolve, reject) => setTimeout(() => resolve(3), 3000)) ]).catch(alert); // 错误：喔！ ~~~ 这里的第二个 promise 在两秒内为 reject。这立即导致了对`Promise.all`的 reject。因此`.catch`被执行：避免 error 成为整个`Promise.all`的结果。重要的细节是 promise 没有提供 "cancel" 或 "abort" 执行方法。因此，其他 promise 会继续执行，并最终为 settle，但它们的结果会被忽略。有避免这种情况的方法：我们可以编写额外的代码到`clearTimeout`（或在出现 error 时取消）promise，或者我们可以将 error 作为结果数组中的成员显示出来（参阅本章下的 task）。 ````smart header="`Promise.all(iterable)`允许在 `iterable` 中无 promise" 通常 `Promise.all(iterable)` 接受可迭代的 promise（大多数情况是数组）。但如果这些对象中的任何一个不是 promise，它就会被封装进 `Promise.resolve`。例如。这里的结果是`[1, 2, 3]`： ~~~js Promise.all([ new Promise((resolve, reject) => { setTimeout(() => resolve(1), 1000) }), 2, // treated as Promise.resolve(2) 3 // treated as Promise.resolve(3) ]).then(alert); // 1, 2, 3 ~~~ 因此我们可以在方便的时候将非 promise 值传递给`Promise.all`。 ~~~ ## Promise.race 与 `Promise.all` 类似，所有的 promise 都是可迭代的，但不会等待所有都完成 —— 只等待第一个完成（或者有 error），然后继续执行。语法是： ```js let promise = Promise.race(iterable); ``` 例如，这里的结果回事 `1`： ```js run Promise.race([ new Promise((resolve, reject) => setTimeout(() => resolve(1), 1000)), new Promise((resolve, reject) => setTimeout(() => reject(new Error("Whoops!")), 2000)), new Promise((resolve, reject) => setTimeout(() => resolve(3), 3000)) ]).then(alert); // 1 ``` 因此，第一个结果/错误会成为整个 `Promise.race` 的结果。在第一个 promise "wins the race" 被解决后，所有的深层的结果/错误都会被忽略。 ## 总结 `Promise` 类有 4 中静态方法： 1. `Promise.resolve(value)` —— 根据给定值返回 resolved promise， 2. `Promise.reject(error)` —— 根据给定错误返回 rejected promise， 3. `Promise.all(promises)` —— 等待所有的 promise 为 resolve 时返回存放它们结果的数组。如果任意给定的 promise 为 reject，那么它就会变成 `Promise.all` 的错误结果，所以所有的其他结果都会被忽略。 4. `Promise.race(promises)` —— 等待第一个 promise 被解决，其结果/错误即为结果。这四个方法中，`Promise.all` 在实战中使用的最多。 ~~~