Swift Promise三态模型深度解析:一文读懂pending、fulfilled与rejected
Swift Promise三态模型深度解析一文读懂pending、fulfilled与rejected【免费下载链接】PromiseA Promise library for Swift, based partially on Javascripts A spec项目地址: https://gitcode.com/gh_mirrors/promi/PromisePromise 是一个基于 JavaScript A 规范设计的Swift 异步库其核心是Swift Promise 三态模型pending等待中、fulfilled已兑现与 rejected已拒绝。本文带你一文读懂这三个状态的来源、流转规则与实际用法帮助新手快速建立对 Swift Promise 的正确心智模型。⏳ 一句话理解Promise 就是一个未来才会有结果的任务而这个结果只有三种可能——还没出来pending、成功了fulfilled、失败了rejected。为什么 Swift Promise 需要三态模型在README.md中官方把 Promise 定义为表示一个未来某个时刻会存在的值或者会以一个错误失败的类型。它和Optional很像——Optional描述值可能在这里而 Promise 描述值将来会在这里。要完整地描述一个未来的结果恰好需要三种状态状态含义类比pending任务还在进行中快递在路上 fulfilled任务成功完成携带结果值已签收 ✅rejected任务失败携带一个错误包裹丢了 ❌系统一旦知道成功长什么样、失败长什么样组合异步操作就变得简单链式调用、并行执行、重试、超时……都建立在三态之上。三态的定义位于核心源文件Promise/Promise.swift中的State枚举enum StateValue: CustomStringConvertible { /// 任务还没完成将来会转为 fulfilled 或 rejected case pending(callbacks: [CallbackValue]) /// 任务成功携带结果值 case fulfilled(value: Value) /// 任务失败携带错误 case rejected(error: Error) }三大状态逐个拆解1️⃣ pending还没出结果的进行中状态每个用默认初始化器创建的 Promise 都从 pending 开始let promise PromiseData() // 创建时即为 pendingpending 状态并非空等它内部保存着一个回调队列callbacks。你在任务完成前挂上去的所有then处理块都会先被登记在这个队列里等任务一结束再统一触发。这就是 Promise 允许先注册、后执行的关键。对于委托delegate风格的回调 API典型做法就是先Promise()建一个 pending 的 Promise等回调到达时再手动改变它的状态。2️⃣ fulfilled成功完成携带结果值调用fulfill(_:)可以把 pending 的 Promise 转为 fulfilled并附上结果值promise.fulfill(data) // 转为 fulfilled携带 data也支持生来就成功let p Promise(value: 42) // 创建即 fulfilledfulfilled 后你可以通过公开的value属性拿到结果用isFulfilled判断状态。3️⃣ rejected失败完成携带错误对称地reject(_:)把 Promise 转为 rejected 并附上一个Errorpromise.reject(error) // 转为 rejected携带 error let p Promise(error: someError) // 创建即 rejectedrejected 后可通过error属性取回错误用isRejected判断状态。三态如何流转记住两条铁律 整个状态机只有两条转换规则非常克制pending → fulfilled 或 rejected二选一只能由fulfill/reject触发一次fulfilled / rejected 是终态一旦确定永不改变。这一点在Promise/Promise.swift的updateState方法中被严格执行——只有当前处于 pending 时状态更新才会生效guard case .pending(let callbacks) self.state else { return }它带来两个重要特性先到先得多次调用fulfill/reject只有第一次生效后续调用被直接忽略。你不必担心状态被覆盖的竞态问题线程安全所有状态读写都经过一个内部串行锁队列lockQueue从多线程并发触发也不会出错。换句话说一个 Promise 的一生最多只走一条路pending → fulfilled或pending → rejected。三态判断属性随时检查 Promise 现在在哪一站Swift Promise 为三个状态分别提供了公开的布尔属性方便你在业务代码中做检查isPending还在进行中isFulfilled已成功isRejected已失败配套的value与error属性则分别只在对应终态下返回值其他情况返回nil。这些判断不是摆设。以Promise/PromiseExtras.swift中的Promises.all为例——它要等所有 Promise 都完成后才兑现判断条件正是!promises.contains(where: { $0.isRejected || $0.isPending })只要还有任何一个处于 pending或者有一个 rejected整体就不会成功。可见三态是整个组合 API 的地基。三态模型解锁的实用能力 理解三态之后库里的常用方法就都说人话了then为 fulfilled 注册处理块若任务仍处于 pending处理块会被暂存等待catch为 rejected 注册错误处理链条中任何一环 rejected后续then全部跳过只走失败分支always不管最终是 fulfilled 还是 rejected 都执行——因为此刻 Promise 一定已离开 pending所以它既不需要值也不需要错误all/race/retry/zip这些组合工具本质上都是对多个 Promise 三态的编排——all等全部 fulfilled、race取第一个完成的、retry在 rejected 后重新来一遍。一个最小示例串起三态let promise PromiseInt(work: { fulfill, reject in // 闭包执行前promise 处于 pending fulfill(42) }).then { value in print(value) // fulfilled 分支42 }.catch { error in print(error) // rejected 分支 }创建到fulfill(42)之间是 pendingfulfill之后是 fulfilledthen分支随之触发。如果工作闭包里抛出异常或显式调用reject则转为 rejected只走catch分支。新手常见问题 FAQQ1Promise 能从 rejected 恢复回 pending 重试吗不能。状态流转是单向的终态不可逆。想重试应该用Promises.retry生成一个新的Promise而不是原地改状态。Q2为什么isFulfilled的实现是value ! nil因为 fulfilled 的定义就是携带了一个值用值是否存在来等价判断简洁且无歧义。Q3pending 期间注册的回调会丢失吗不会。这正是 pending 携带callbacks队列的意义——回调会按注册顺序在状态确定后依次触发。总结三句话记住 Swift Promise 三态模型每个 Promise 都处于且仅处于pending / fulfilled / rejected三者之一状态只能从 pending 单向走向某个终态先到先得、永不再变fulfill附带值、reject附带错误then/catch/always则分别对应成功做什么、失败做什么、无论成败做什么。掌握这三态你就掌握了Promise/Promise.swift与Promise/PromiseExtras.swift中所有 API 的运行逻辑Swift 异步编程的下一站——链式调用与组合编排——也就顺理成章了。【免费下载链接】PromiseA Promise library for Swift, based partially on Javascripts A spec项目地址: https://gitcode.com/gh_mirrors/promi/Promise创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

基于SpringBoot框架的智慧养老平台设计与实现源码+文档

基于SpringBoot框架的智慧养老平台设计与实现源码+文档

温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片! 温馨提示:本人主页置顶文章(点我)开头有 CSDN 平台…

2026/11/18 20:30:56 阅读更多 →
荒岛求生1.1.2正式版来啦!

荒岛求生1.1.2正式版来啦!

知道大家在机房里上课很无聊&#xff0c;于是……老规矩&#xff0c;留下关注与点赞呗本次更新修复了部分已知bug&#xff0c;即使不够完善&#xff0c;但我仍会努力趋于完美求求了&#xff01;代码在这里……&#xff08;还不快去点赞&#xff1f;&#xff09;#include<bit…

2026/10/24 18:47:05 阅读更多 →
alpha-rptr应对Binance Algo Service迁移:交易所API变更下升级交易机器人的实战案例

alpha-rptr应对Binance Algo Service迁移:交易所API变更下升级交易机器人的实战案例

alpha-rptr应对Binance Algo Service迁移&#xff1a;交易所API变更下升级交易机器人的实战案例 【免费下载链接】alpha-rptr A trading bot for automated algorithmic trading on Binance Futures, Bybit, BitMEX and FTX written in python. 项目地址: https://gitcode.co…

2026/11/17 6:03:45 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年&#xff0c;我大部分时间都在跟浏览器标签页打交道&#xff0c;直到第一次把桌面应用跑起来&#xff0c;才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词&#xff0c;最开始是在某段时间频繁出现在同事的讨论里&#xff0c;一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档&#xff0c;主要面向智能锁安装人员、终端用户及售后维护者&#xff0c;帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件&#xff0c;大小4.37MB&#xff0c;内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统&#xff0c;整车要求空载跑到8m/s&#xff0c;电机转速已经拉到额定点&#xff0c;驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令&#xff0c;转速纹丝不动&#xff0c;三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年&#xff0c;用它写过嵌入式驱动、做过游戏服务端&#xff0c;也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词&#xff0c;我其实挺感慨的——这门语言的难点从来不是语法多&#xff0c;而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书以PDF格式发布&#xff0c;适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开&#xff0c;先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能&#xff0c;再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历&#xff1a;翻开源码注释、论文摘要或者一份专业报告&#xff0c;每个字都认识&#xff0c;连在一起却像天书。想找人聊聊&#xff0c;身边要么没人懂&#xff0c;要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型&#xff0c;几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻