Generator 可作为表单向导状态机核心,通过 yield 控制步骤流转、传入 action 决定跳转、yield Promise 处理异步、throw/error 保持当前页、useRef + useReducer 实现 React 集成。

Generator 可以用作表单向导的状态机核心,把每一步的校验、跳转、回退逻辑封装成可中断、可恢复的执行单元,避免状态散落在多个回调或 Redux action 中。
用 yield 控制步骤流转,每个 step 是一个可暂停的执行点
把整个向导流程定义为一个 Generator 函数,每调用一次 next() 就推进到下一步,返回当前步骤的配置(如标题、字段、校验规则)和控制指令(是否允许前进/后退、是否需异步加载)。这样状态完全由 Generator 的内部指针(yield 位置)决定,不依赖外部变量追踪“当前第几步”。
- 每步 yield 一个纯对象,例如
{ step: 'contact', title: '联系信息', fields: ['email', 'phone'], validate: () => isValidEmail() } - 调用 next({ action: 'next' }) 或 next({ action: 'back' }) 向 Generator 传入用户操作,让它决定下一步该 yield 哪个步骤
- Generator 内部用 switch 或 if 判断 action 类型,结合当前状态计算下一环节,天然支持条件分支(比如“若选了企业账户,则跳过个人认证”)
异步操作不打断状态流:用 yield Promise 实现等待即暂停
表单中常有异步校验(如用户名是否已存在)、动态加载(如根据国家加载省份下拉)、提交前预检。Generator 配合 async/await 不直接兼容,但可以 yield Promise,由外部执行器统一 await 并将结果传回 next() —— 这样异步等待期间 Generator 暂停,状态不丢失,也不需要额外加 loading 标志位。
- 在 Generator 中写
yield fetch('/api/check-username?name=' + name) - 执行器捕获这个 Promise,await 它,拿到响应后再调 next(result),result 就是接口返回数据
- 后续步骤逻辑可基于 result 决策,比如
if (result.available) yield nextStep; else yield errorStep;
错误与回退不破坏执行上下文:throw 和 return 协同处理异常路径
用户点击“上一步”时,不是简单减索引,而是让 Generator 执行 return() 或 throw() 主动退出当前步骤;遇到校验失败,可 throw 自定义错误,由外层捕获并展示提示,同时保持 Generator 在原地——下次 next() 仍从同一 yield 继续,不会跳过当前页。
立即学习“Java免费学习笔记(深入)”;
-
return() 适合正常退出(如完成所有步骤),Generator 状态变为
done: true,可触发最终提交 - throw(new ValidationError('邮箱格式错误')) 让 Generator 跳出当前步骤但不结束,外层 catch 后可聚焦错误字段,且 next() 仍 yield 当前 step 对象,实现“卡在本页不离开”
- 配合 try/catch 在 Generator 内部也能做局部错误恢复,比如某字段异步校验失败后自动重试两次再报错
与 React 结合:用 useRef 保存 Generator 实例,用 useReducer 管理 UI 状态
React 组件内初始化 Generator 实例并存进 useRef,避免每次渲染重建;UI 状态(当前页码、loading、错误信息)用 useReducer 管理,action 类型(NEXT、BACK、SUBMIT)触发 Generator 的 next/throw,reducer 根据 Generator 返回值更新 UI 状态。
- useRef 缓存 generator = formWizard(),保证跨渲染的执行上下文一致
- dispatch({ type: 'NEXT', payload: formData }) → 调用 generator.next({ action: 'next', data: formData })
- reducer 根据 { value: { step, title, fields }, done: false } 更新 currentStep 和 fields;若 done: true,则触发 onSubmit
- 无需 useEffect 监听状态变化来驱动步骤,所有流转都由用户交互直接触发 Generator,响应更确定


















