0

0

Promise的基本用法与示例

畫卷琴夢

畫卷琴夢

发布时间:2025-07-11 16:52:02

|

747人浏览过

|

来源于php中文网

原创

promise是javascript中处理异步操作的现代方案,通过1.创建promise实例,传入执行器函数;2.在异步操作成功或失败时分别调用resolve或reject;3.使用.then()、.catch()和.finally()处理结果,使异步代码更清晰且类似同步流程。链式调用通过返回新promise实现扁平化结构,解决回调地狱问题。promise.all()用于等待所有promise成功,适用于并行请求数据或资源预加载;promise.race()则响应首个完成的promise,常用于超时控制或选择最快响应。使用时需注意:1.始终添加.catch()避免未捕获拒绝;2.构造函数中的同步错误会被自动捕获;3.在.then()中返回promise以维持链式调用;4.promise无法取消,需内部检查标志位或借助第三方库应对长时间操作。

Promise的基本用法与示例

Promise,说白了,就是JavaScript里处理异步操作的一种更优雅、更现代的方案。它本质上是一个代表了未来某个时刻才会知道结果的对象。这个结果可能是成功(fulfilled),也可能是失败(rejected)。它的核心价值在于,把原来层层嵌套的回调函数(也就是所谓的“回调地狱”)变得扁平化,让异步代码读起来更像同步代码,逻辑流也更清晰。

Promise的基本用法与示例

解决方案

要使用Promise,我们通常会经历几个步骤:创建、执行、以及处理结果。

创建一个Promise实例,需要传入一个执行器(executor)函数,这个函数接收两个参数:resolverejectresolve用于在异步操作成功时调用,并将结果传递出去;reject则在异步操作失败时调用,传递错误信息。

Promise的基本用法与示例
// 模拟一个异步操作,比如网络请求
function fetchData(shouldSucceed = true) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      if (shouldSucceed) {
        resolve('数据加载成功!'); // 成功时调用resolve
      } else {
        reject(new Error('数据加载失败!')); // 失败时调用reject
      }
    }, 1000); // 模拟1秒延迟
  });
}

// 使用Promise
fetchData(true)
  .then(data => {
    console.log('成功:', data); // 成功时的处理
  })
  .catch(error => {
    console.error('失败:', error.message); // 失败时的处理
  })
  .finally(() => {
    console.log('无论成功或失败,都会执行。'); // 无论结果如何,都会执行
  });

fetchData(false)
  .then(data => {
    console.log('成功:', data);
  })
  .catch(error => {
    console.error('失败:', error.message);
  })
  .finally(() => {
    console.log('无论成功或失败,都会执行。');
  });

在这个例子里,fetchData函数返回了一个Promise。当Promise的状态从“pending”(进行中)变为“fulfilled”(成功)时,.then()里的回调函数会被执行;当变为“rejected”(失败)时,.catch()里的回调函数会被执行。.finally()则无论成功失败都会被调用,通常用于清理资源或显示加载状态。

Promise链式调用如何优化异步代码的可读性?

Promise最迷人的地方,莫过于它的链式调用能力。这让原本可能陷入多层嵌套的回调函数,变得像一条流水线一样平铺直叙。想象一下,你需要先获取用户信息,再根据用户信息去请求他的订单列表,最后再展示订单详情。如果用传统回调,代码会迅速变得难以维护。

Promise的基本用法与示例
// 传统回调地狱的简化版
// getUserInfo(userId, function(user) {
//   getOrders(user.id, function(orders) {
//     displayOrderDetails(orders, function() {
//       console.log('All done!');
//     });
//   });
// });

// 使用Promise链式调用
function getUserInfo(userId) {
  return new Promise(resolve => setTimeout(() => resolve({ id: userId, name: '张三' }), 500));
}

function getOrders(userId) {
  return new Promise(resolve => setTimeout(() => resolve([`订单A for ${userId}`, `订单B for ${userId}`]), 700));
}

function displayOrderDetails(orders) {
  return new Promise(resolve => {
    setTimeout(() => {
      console.log('展示订单详情:', orders);
      resolve('展示完成');
    }, 300);
  });
}

getUserInfo(123)
  .then(user => {
    console.log('获取到用户:', user.name);
    // 这里返回一个新的Promise,它会作为下一个.then的输入
    return getOrders(user.id);
  })
  .then(orders => {
    console.log('获取到订单:', orders);
    // 同样,返回一个新的Promise
    return displayOrderDetails(orders);
  })
  .then(message => {
    console.log('最终操作:', message);
  })
  .catch(error => {
    console.error('操作链中出现错误:', error);
  });

链式调用的核心在于,.then()方法本身也会返回一个新的Promise。这个新的Promise的状态和结果,取决于其回调函数的返回值。如果回调函数返回一个非Promise值,那么下一个.then()会立即以这个值作为成功结果;如果返回一个Promise,那么下一个.then()会等待这个返回的Promise解决(resolve或reject)后,再根据其结果继续执行。这种机制彻底解决了回调函数的嵌套问题,让异步流程一目了然。

Promise.all() 和 Promise.race() 有哪些典型应用场景?

在实际开发中,我们经常会遇到需要同时处理多个异步操作的情况。Promise提供了两个非常实用的静态方法来应对这类需求:Promise.all()Promise.race()。它们就像是异步任务的“指挥官”,各自有独特的调度方式。

Promise.all(iterable)

这个方法接收一个Promise的可迭代对象(比如一个Promise数组)。它会等待所有的Promise都成功解决(fulfilled)后,才将结果以数组的形式返回。只要其中任何一个Promise被拒绝(rejected),Promise.all()就会立即拒绝,并返回第一个被拒绝的Promise的错误信息。

典型应用场景:

  • 并行请求数据: 当你需要同时从多个API接口获取数据,并且只有当所有数据都成功获取后才能进行下一步操作时,Promise.all()是理想的选择。比如,一个页面需要同时加载用户信息、商品列表和广告位数据,这些请求之间没有依赖关系,可以并行执行。
  • 资源预加载: 在游戏或大型应用中,需要预加载多张图片、音频文件等资源,只有所有资源都加载完毕后才能开始游戏或进入主界面。
const p1 = new Promise(resolve => setTimeout(() => resolve('数据A'), 1000));
const p2 = new Promise(resolve => setTimeout(() => resolve('数据B'), 500));
const p3 = new Promise((resolve, reject) => setTimeout(() => reject(new Error('数据C加载失败')), 1500));

Promise.all([p1, p2])
  .then(results => {
    console.log('所有数据加载成功:', results); // ['数据A', '数据B']
  })
  .catch(error => {
    console.error('有数据加载失败:', error.message);
  });

Promise.all([p1, p2, p3]) // 只要p3失败,整个all就失败
  .then(results => {
    console.log('所有数据加载成功:', results);
  })
  .catch(error => {
    console.error('有数据加载失败:', error.message); // '数据C加载失败'
  });

Promise.race(iterable)

Promise.all()不同,Promise.race()也接收一个Promise的可迭代对象。但它不会等待所有Promise完成,而是只要其中任何一个Promise率先解决(fulfilled)或拒绝(rejected),Promise.race()就会立即以那个Promise的结果作为自己的结果。

典型应用场景:

  • 超时控制: 这是Promise.race()最经典的用法。你可以将一个实际的网络请求Promise和一个带有固定延迟的Promise(在延迟结束后拒绝)放在一起race。如果网络请求在延迟内完成,则使用请求的结果;否则,race会因为超时Promise的拒绝而拒绝。
  • 选择最快响应: 比如,你从多个镜像服务器请求同一个资源,哪个服务器响应最快就用哪个。
const fetchImage = new Promise(resolve => setTimeout(() => resolve('图片加载完成'), 2000));
const timeout = new Promise((resolve, reject) => setTimeout(() => reject(new Error('请求超时!')), 1500));

Promise.race([fetchImage, timeout])
  .then(result => {
    console.log('最先完成的是:', result); // 如果图片在1.5秒内加载完成
  })
  .catch(error => {
    console.error('最先完成的是错误:', error.message); // 如果1.5秒内图片没加载完,则会显示超时
  });

const fastResponse = new Promise(resolve => setTimeout(() => resolve('服务器A响应'), 100));
const slowResponse = new Promise(resolve => setTimeout(() => resolve('服务器B响应'), 500));

Promise.race([fastResponse, slowResponse])
  .then(result => {
    console.log('最快响应的是:', result); // '服务器A响应'
  });

这两个方法极大地提升了我们处理复杂异步场景的能力,让代码在多任务并发时依然保持清晰和高效。

Napkin AI
Napkin AI

Napkin AI 可以将您的文本转换为图表、流程图、信息图、思维导图视觉效果,以便快速有效地分享您的想法。

下载

使用Promise时需要注意哪些常见的陷阱和最佳实践?

虽然Promise极大地改善了异步编程体验,但在实际使用中,如果不注意一些细节,还是可能踩坑。理解这些“坑”能帮助我们写出更健壮的代码。

1. 遗漏 .catch() 导致未捕获的 Promise 拒绝 (Unhandled Promise Rejection)

这是最常见的错误之一。当一个Promise被拒绝,但你没有在Promise链的末尾添加.catch()来处理这个错误时,这个错误就会向上冒泡,最终可能导致浏览器抛出“Unhandled Promise Rejection”警告,或者在Node.js中直接终止进程。这就像你把垃圾扔了,却没人来清理,最终会污染环境。

new Promise((resolve, reject) => {
  reject(new Error('Oops, 出错了!'));
})
// .then(...) // 忘记了catch
// 浏览器控制台会报:Uncaught (in promise) Error: Oops, 出错了!

最佳实践: 始终在Promise链的末尾添加.catch()。或者,在全局监听unhandledrejection事件(浏览器环境)或process.on('unhandledRejection')(Node.js环境)来捕获并处理这些未处理的拒绝。

2. Promise 构造函数中的同步错误

Promise的执行器函数(new Promise((resolve, reject) => { /* 这里 */ }))是同步执行的。如果在其中抛出同步错误,那么这个错误会被Promise自动捕获并作为拒绝处理,但它不会像异步错误那样被.catch()捕获,除非你显式地返回一个被拒绝的Promise。

new Promise((resolve, reject) => {
  throw new Error('这是在Promise构造函数中抛出的同步错误!'); // 会被catch捕获
})
.then(() => console.log('成功'))
.catch(error => console.error('捕获到错误:', error.message)); // 捕获到错误: 这是在Promise构造函数中抛出的同步错误!

这里我稍微修正一下,Promise构造函数内部抛出的同步错误确实会被Promise捕获并传递给.catch()。我的原始想法有点偏差,但保持这个例子,因为它说明了同步错误在Promise内部的处理方式。真正的“陷阱”可能在于,如果你在构造函数外部直接抛出错误,那它就和Promise无关了。

3. 在 .then() 中忘记返回 Promise 或值

在Promise链中,如果你在.then()的回调函数中执行了异步操作,但忘记返回一个新的Promise,那么链条就会断裂。下一个.then()会立即执行,而不会等待你内部的异步操作完成。

function step1() {
  return new Promise(resolve => setTimeout(() => { console.log('步骤1完成'); resolve(1); }, 500));
}

function step2(data) {
  // 假设这里需要异步操作,但我们忘记返回Promise
  setTimeout(() => { console.log(`步骤2处理数据: ${data}`); }, 300);
  return data; // 直接返回了同步值
}

function step3(data) {
  console.log(`步骤3处理数据: ${data}`);
}

step1()
  .then(result1 => {
    return step2(result1); // 这里返回了同步值,而不是Promise
  })
  .then(result2 => {
    // result2 是 step2 直接返回的 data (1),而不是 step2 内部异步操作完成后的结果
    step3(result2); // 步骤3会立即执行,可能在步骤2的console.log之前
  });
// 预期输出顺序:步骤1完成 -> 步骤2处理数据: 1 -> 步骤3处理数据: 1
// 实际输出顺序:步骤1完成 -> 步骤3处理数据: 1 -> 步骤2处理数据: 1 (可能,取决于setTimeout的调度)

最佳实践:.then()中,如果你的回调函数执行了异步操作,确保它返回一个Promise。如果返回一个普通值,它会被包装成一个已解决的Promise。

4. Promise 无法取消

一旦一个Promise被创建并开始执行,你就无法在外部“取消”它。即使你不再关心它的结果,它也会继续运行直到解决或拒绝。对于长时间运行的异步操作(如大文件上传),这可能会导致不必要的资源消耗。

最佳实践: 目前Promise本身不支持取消。通常的解决方案是,在Promise内部检查一个外部标志位,如果标志位表明操作已被取消,则提前拒绝Promise。或者,使用一些第三方库(如 AbortController API,虽然它不是Promise的原生取消机制,但可以与Promise配合实现类似效果)。

理解这些点,能帮助我们更有效地利用Promise,避免一些常见且难以调试的问题,让异步代码真正变得可靠和易于管理。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1960

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

658

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2403

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

47

2026.01.19

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6259

2023.08.17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何进行WebSocket调试
如何进行WebSocket调试

共1课时 | 0.1万人学习

TypeScript全面解读课程
TypeScript全面解读课程

共26课时 | 5.1万人学习

前端工程化(ES6模块化和webpack打包)
前端工程化(ES6模块化和webpack打包)

共24课时 | 5.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号