SuperAPI AI 工具集

solid-js-2x-api-changes-and-best-practices

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:面向 SolidJS 2.x beta 或 next 版本,帮助编写新代码、解释 API 与警告、评审已采用新语义的代码,并对比 1.x 与 2.x 行为。以当前 beta 迁移指南与 RFC 为准,部分 API 或包边界在正式版前仍可能变动;本地依赖与指南冲突时以仓库安装版本为准。

主要能力:createSignal 写入按微任务批处理,flush 后才可见;createMemo 支持显式异步派生,追踪读取必须在 await 之前;createEffect 拆为 compute 与 apply 两阶段,cleanup 归 apply;onSettled 替代 onMount;Loading 作首屏异步就绪边界,Errored 作错误边界;isPending、latest、refresh 用于异步协调;action 配合 createOptimistic、createOptimisticStore 处理变更与乐观更新;createProjection、函数式 createStore 用于投影与键控协调;createStore 迁入 solid-js,优先草稿式 setter,snapshot 替代 unwrap,merge 替代 mergeProps,omit 替代 splitProps,storePath 仅作兼容;createContext 对象直接作 provider;For 以 keyed={false} 替代 Index,Repeat 用于计数渲染;ref 工厂替代 use: 指令;createRoot 在受控作用域内默认归父级所有。

已移除或替换:solid-js/web 等子路径移至 @solidjs/*,store 并入 solid-js;Suspense→Loading,ErrorBoundary→Errored,createSelector→createProjection,unwrap→snapshot,classList→class,createResource、startTransition/useTransition、batch、Context.Provider、createComputed、use: 指令、attr:/bool:/oncapture: 均移除。

适用场景:全新 2.x 代码、窄范围 API 解释、警告分流、新语义代码评审;升级旧应用请用专门的迁移技能,Start 应用需配合 SolidStart 技能。

限制:资料到“use re”处截断,后续内容暂未提供;不得凭空引入 createAsync、mount、路由助手或 Start 特有模式,除非仓库确认存在这些导出。