【免费下载链接】emulateLocal API emulation for CI and no-network sandboxes项目地址https://gitcode.com/gh_mirrors/emul/emulate点击查看免费下载emulate 是一个本地 API 模拟local API emulation工具帮助开发者在 CI 和无网络沙箱中模拟 GitHub、Stripe、Slack 等服务的接口。它的状态默认保存在内存中重启即清空——而emulate 状态持久化机制让模拟数据在重启后依然保留。本文带你快速上手三种持久化方案filePersistence本地文件适配器、KV 存储适配器以及带stateVersion的版本化快照。为什么模拟状态默认是易失的emulate 的设计哲学是快、可重置、适合 CI全部状态由内存中的Store持有启动时从 seed 配置填充测试结束随时可重置。这意味着每次冷启动都会丢失上一轮运行产生的数据——比如 OAuth 回调创建的会话、下单产生的订单记录。架构说明可参考apps/web/app/docs/architecture/page.mdx当你的场景需要像真实服务一样记住状态本地联调、跨重启复现 Bug就需要开启持久化。场景推荐方式关键 APICLI 启动自定义 API保存到本地文件配置中直接写文件路径persistence: ./.emulate/xxx.json编程式 / Next.js / Nuxt 嵌入内置文件适配器或自定义 KV 适配器filePersistence(path)、load()/save()状态结构会随版本演进版本化快照 stateVersionsnapshot()/restore()一键上手CLI 里用文件路径开启持久化对自定义 API只要在 emulate.config.ts 的服务条目中加上一个persistence文件路径即可相对路径会基于配置文件所在目录解析见 config-loader.tsservices: { inventory: { emulator: inventory, persistence: ./.emulate/inventory.json, }, }运行时的语义非常清晰冷启动自动load()恢复已保存的状态seed 仅作为 reset 基线变更之后每次状态被修改包括会改状态的读请求和流式响应结束/取消时都会序列化save()保存操作经过串行化不会写坏文件重置与关闭reset()、restore()和受控关闭同样会持久化当前状态无跨进程锁同一状态仍由单进程持有多进程场景需自行规避。完整生命周期表格见官方文档 custom-apis 指南完整可运行示例在 examples/custom-api/emulate.config.ts 与 examples/custom-api/emulators/inventory.ts。编程式接入filePersistence 的原子写细节在代码中启动模拟器测试、Next.js/Nuxt 适配器时emulators/core内置了filePersistence一个路径就能获得生产级的文件适配器import { filePersistence } from emulators/core persistence: filePersistence(.emulate/state.json),它的实现persistence.ts值得新手留意临时文件 rename先写入*.tmp再原子重命名避免写一半的文件被读取目录权限 0600状态文件常含模拟密钥默认只对属主可读写initialize原子创建或读取用硬链接link保证并发的首次启动只落一份初始数据已有文件则直接读取现值。相关边界条件父目录自动创建、临时文件清理、并发初始化都有针对性测试覆盖可阅读 persistence.test.ts 学习验收标准。⚡进阶编写 KV 存储适配器persistence也可以传入任意实现了 PersistenceAdapter 接口的对象接口只有三个异步方法load()→ 读取状态字符串不存在时返回nullsave(data)→ 写入状态字符串initialize?(data)→ 原子地创建或读取供需要生成身份信息的内置服务使用Next.js 接入示例对接 KV 数据库见 README 持久化章节const kvAdapter { async load() { return await kv.get(emulate-state) }, async save(data: string) { await kv.set(emulate-state, data) }, } export const { GET, POST } createEmulateHandler({ services: { github: { emulator: github } }, persistence: kvAdapter, })Nuxt 接入可改用useStorage示例见 README Nuxt 持久化章节适配器用法分别在 adapter-next/README.md 与 adapter-nuxt/README.md。CLI 路径下字符串会被自动包装成filePersistence并在保存前做一层有变更才写的缓冲见 project-runner.ts。版本化快照stateVersion 让状态可以升级内置服务GitHub、Stripe 等的状态由Store管理snapshot()会导出所有集合与键值数据Map/Set等特殊类型会被安全序列化/反序列化store.ts、serialize 逻辑恢复时还会删除快照中不存在的集合。自定义 API 的快照则带有三件套元数据custom.tsformatVersion快照格式版本definition属于哪个模拟器定义stateVersion状态结构的版本在定义中声明修改持久化形状时递增恢复时若stateVersion不匹配emulate 会显式报错而不是静默产生脏数据Incompatible snapshot for xxx. Supply a matching stateVersion or migrate the saved snapshot.校验逻辑。快照本身是脱离副本restore()只替换当前状态不破坏原始 reset 基线——这正是版本化快照的价值数据结构变更时你可以先snapshot()导出、手动迁移、再恢复而不会丢失现场。最佳实践清单✅seed 是基线不是初始值有持久化文件后启动时恢复的是已保存状态seed 只作为 reset 的回退基线。✅watch 重载会重建基线成功的 watch 重载会捕获新基线并重置本轮运行持久化文件不受影响。✅快照里含生成的密钥内置服务的持久化快照会包含生成的身份密钥请把.emulate/目录加入.gitignore并保持后端私有。⚠️无跨进程锁load/save不提供多进程互斥同一实例只应被一个进程使用。⚠️后台变更不在自动边界内任意后台任务做的状态变更不自动落盘请在请求处理或显式保存点完成变更。相关资源官方文档持久化与生命周期apps/web/app/docs/custom-apis/page.mdx架构总览内存状态与插件系统apps/web/app/docs/architecture/page.mdx内置文件适配器源码packages/emulators/core/src/persistence.ts核心 Store 快照实现packages/emulators/core/src/store.ts完整自定义 API 示例examples/custom-api/持久化行为测试packages/emulators/core/src/tests/persistence.test.ts赞分享【免费下载链接】emulateLocal API emulation for CI and no-network sandboxes项目地址https://gitcode.com/gh_mirrors/emul/emulate点击查看免费下载相关推荐为什么选择Gridster.js探索这款jQuery插件的独特优势为什么选择Gridster.js探索这款jQuery插件的独特优势 Gridster.js是一个功能强大的jQuery插件专门用于创建直观的可拖拽网格布局系GitHub_Trending/chef5/chef快照管理snapshot.client.ts与状态持久化方案GitHub_Trending/chef5/chef快照管理snapshot.client.ts与状态持久化方案 你是否曾因浏览器崩溃丢失数小时的开发成果是人工智能AI 应用AI Agent大模型代码生成前端后端构建零信任认证体系Better Auth环境变量架构设计与安全实践构建零信任认证体系Better Auth环境变量架构设计与安全实践 在现代微服务架构和云原生环境中认证系统的安全性直接关系到整个应用生态的稳定。Better认证鉴权后端身份认证创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考