该技能面向从 React 18 或更早版本迁移到 React 19,以及在新项目中编写 React 19 组件与 Hooks 的开发者,定位是“变更说明”而非完整 React 参考。资料明确说明其聚焦 React 19 改了什么,并提供了从 React 16/17 升级的路径建议:先升级到 React 18.3 以查看弃用警告,再升级到 19。
思维模型方面,资料列出 React 19 的多项范式转变:从默认客户端渲染转向服务端优先(RSC 默认)、从手动记忆化转向编译器自动处理、从 useEffect 取数据转向异步 Server Components、从 useState 管理表单转向 Form Actions、从加载状态布尔值转向 Suspense 边界等。对应还提供了 paradigm-shifts.md(思维模型)与 anti-patterns.md(应停止使用的旧模式)两个参考文档。
主要能力包括:ref 作为普通 prop(forwardRef 将被弃用)、ref 回调返回清理函数、Context 可直接作为 Provider;新增 Hooks 如 useActionState(表单动作状态与 pending)、useOptimistic(乐观更新)、use()(在渲染中读取 Promise、条件式读取 Context)、useFormStatus(react-dom,读取父表单状态);Form Actions 支持函数直接传给 form action 及按钮级 formAction,并提供 requestFormReset;文档元数据(title、meta、link)自动提升到 head;资源预加载 API(prefetchDNS、preconnect、preload、preinit)与带 precedence 的样式表支持;Custom Elements 完整支持;水合错误改为单条带 diff 的提示,并更好的兼容第三方脚本注入。
资料还列出移除的 API 与迁移方式:ReactDOM.render、ReactDOM.hydrate、unmountComponentAtNode、findDOMNode、propTypes、函数组件的 defaultProps、字符串 ref、旧版 Context、React.createFactory、react-dom/test-utils 等。TypeScript 方面,useRef 必须传参、ref 回调不得有隐式返回值、ReactElement 的 props 类型变为 unknown、JSX 命名空间需显式导入。迁移可使用 codemod 命令,如 npx codemod@latest react/19/migration-recipe 及 types-react-codemod 的 preset-19。
React 19.2+ 新增 Activity 组件(隐藏时保留状态、清理 Effects)与 useEffectEvent(从 Effect 中提取非响应式逻辑)。错误处理新增 onUncaughtError、onCaughtError、onRecoverableError 回调。
使用方式上,该技能以参考文档与代码示例形式呈现,资料未提供安装命令或平台接入方式,相关细节暂未提供。适用场景为 React 19 组件与 Hooks 编写、版本迁移、表单与服务端动作开发、TypeScript 类型迁移。限制在于内容不是完整 React 参考,不覆盖未提及的 API 细节。