第78章 状态机
案例 78:状态机 — 实现一个可复用的流程状态切换器
在实际业务中,按钮的“待审核 → 审核中 → 已通过/已驳回”是最典型的状态流转场景。本案例使用 TypeScript 的联合类型与映射表实现一个类型安全的状态机,不允许非法转移,并在每次切换时打印审计日志。
设计思路
定义状态为字符串字面量联合类型;用 Record<State, Partial<Record<State, string>>> 声明允许的转移表;类中持有当前状态并暴露 transition() 方法,内部校验转移合法性后更新状态并回调日志函数。
核心代码
type State = 'idle' | 'loading' | 'success' | 'error';
// 允许的转移表:key 为当前状态,value 为可转移到的状态及说明
const transitions: Record<State, Partial<Record<State, string>>> = {
idle: { loading: '开始请求' },
loading: { success: '请求成功', error: '请求失败' },
success: {},
error: { idle: '重置' }
};
class ButtonStateMachine {
private state: State = 'idle';
transition(to: State): boolean {
const allowed = transitions[this.state];
if (allowed && allowed[to]) {
console.log(`[${this.state} → ${to}] ${allowed[to]}`);
this.state = to;
return true;
}
console.error(`非法转移:${this.state} → ${to} 被阻止`);
return false;
}
get current(): State { return this.state; }
}
// 演示流程
const sm = new ButtonStateMachine();
sm.transition('loading'); // 合法
sm.transition('success'); // 合法
sm.transition('loading'); // 非法 — 会被拦截
运行结果验证
控制台输出三行:前两行为合法转移日志,第三行为红色错误提示“非法转移:success → loading 被阻止”。状态最终停留在 success。
测试建议
可依次调用 transition('error') 后再 transition('idle') 验证错误恢复路径;或尝试从 success 直接跳 idle,应被拒绝。
注意事项
转移表使用
Partial 确保未定义的转移自动为 undefined,避免遗漏判断;状态机适用于流程固定、分支可控的场景,不适合复杂的并发状态。
提示:如需启用“从 success 返回 idle”的审核流程,只需在
success 节点中添加 idle: '重新审核' 一行即可,充分体现映射表驱动状态机的扩展性。