游戏引擎 / 系统课时
看懂 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,后续因此提前继续。

同时观察成功与抛错
文件:main.ts,完整纯 TypeScript 主例程,strict 编译后运行 dist/main.js。
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; });预期输出:
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。