SuperAPI AI 工具集

tanstack-db-skills-tanstack-db-mutations

通用与其它

查看项目

更新于 10-16 00:02

技能介绍

用途:整理 TanStack DB 的变更(Mutations)模式,覆盖插入、更新、删除、乐观更新、事务、节流变更与错误处理。

主要能力:集合级变更支持 insert、update(Immer 风格 draft)、delete,可单条或批量;创建集合时通过 onInsert、onUpdate、onDelete 处理器把变更持久化到服务端。可用 createOptimisticAction 定义基于意图的变更,支持跨多个集合的乐观更新。createTransaction 支持手动事务与 autoCommit 控制,可累积变更后统一 commit 或 rollback。usePacedMutations 提供 debounceStrategy、throttleStrategy、queueStrategy 三种节奏策略。变更可携带 metadata 供处理器区分意图;通过 tx.state 与 tx.isPersisted.promise 等待持久化结果;支持非乐观变更(optimistic: false)。同一事务内对同一项的多次变更会合并(如 insert+delete 抵消、update+delete 以 delete 为准)。

使用方式:在 createCollection 的 queryCollectionOptions 中定义 onInsert/onUpdate/onDelete,调用集合的 insert/update/delete 方法;复杂场景用 createOptimisticAction 或 createTransaction;表单自动保存、滑块、文件上传等分别用 debounce、throttle、queue 策略。

适用场景:需要即时反馈并最终与服务端同步的前端数据层,如待办、点赞、批量审核、表单自动保存。

限制:资料未提供具体版本要求、性能数据、收费信息与完整错误重试实现细节;临时 ID 处理建议优先使用客户端生成的 UUID。