游戏引擎 / 系统课时

看懂 Promise 链里的状态

看懂 Promise 链里的状态

资源准备完成后还要检查数据并更新状态,任何一段失败都应该走到可观察的错误出口。本节通过成功与失败两条 Promise 链理解 pending、fulfilled、rejected 的变化,说明 then 返回值如何传递,以及 catch 为什么既能处理错误也能改变后续结果。

学习目标

  • 区分 Promise 的等待、成功和失败状态。
  • 正确返回下一步结果或 Promise。
  • 为链中抛错设置明确的失败出口。

一条链的每一步都有自己的结果

Promise 表示未来结果,pending 可能一直等待;一旦确定为 fulfilled 或 rejected,就不能再次改变。then 会返回新的 Promise:回调返回普通值,后续接收这个值;返回另一个 Promise,后续等待它;回调抛错,后续进入拒绝路径。

resolve 并不表示下一行自动等到任务完成,then 的回调仍按异步调度执行。reject 也不会被普通同步 try/catch 自动捕获,必须返回链、await 它或在链上设置 catch。最常见的漏项是回调里启动任务却没有 return,后续因此提前继续。

Promise 链结果传递

同时观察成功与抛错

文件:main.ts,完整纯 TypeScript 主例程,strict 编译后运行 dist/main.js。

ts
export {};
function prepare(valid: boolean): Promise<string> {
    return Promise.resolve({ hp: valid ? 20 : -1 })
        .then(config => {
            // 解析成功不等于业务数据有效,检查可以使链失败。
            if (config.hp < 0) throw new Error('invalid hp');
            return config.hp;
        })
        .then(hp => `ready:${hp}`)
        .catch((error: unknown) => {
            // 返回替代结果意味着本函数选择恢复,不再向外拒绝。
            return error instanceof Error ? `failed:${error.message}` : 'failed:unknown';
        });
}
async function main(): Promise<void> {
    console.log(await prepare(true));
    console.log(await prepare(false));
}
void main().catch((error: unknown) => { throw error; });

预期输出:

text
ready:20
failed:invalid hp

配置来源在本例中是内存夹具,不是真实资源请求;实际加载器返回 Promise 后也可以采用相同链式规则。第一条链完成两次转换,第二条在检查处抛错,跳过成功转换并进入 catch。外层入口仍处理未预料的错误,避免留下悬空拒绝。

决定错误是否继续传播

catch 返回字符串后,prepare 的返回类型是 Promise<string>,调用者必须理解这个字符串包含失败结果。若上层需要用异常控制流程,可以在 catch 中记录后重新 throw;不要一边返回默认成功数据,一边期待上层 catch 仍收到同一错误。

finally 适合恢复忙碌标记等无论成败都要做的清理,通常不替换正常结果;若 finally 自己抛错,仍可能使整条链失败。清理逻辑应尽量短且可靠,不应悄悄启动新的未等待任务。

把等待与取消分开

Promise 本身没有通用取消按钮。不再等待结果、忽略旧结果或给 Promise 包装超时,都不等于底层资源请求停止。需要取消网络请求时应使用对应 API 支持的取消机制;引擎资源请求是否可取消也必须单独确认。

练习在第一个 then 内返回一个 Promise.resolve 的数值,确认后续仍得到正确结果;再改为 throw,确认进入失败出口。重点观察返回路径,而不是在每一步追加重复日志。Promise 运行语义可参照 MDN Promise。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 Promise 链里的状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通