@ api- 模拟器/ 核心
HTTP服务器,内存存储器,插件接口,以及相模服务插件的中间软件.
部分 模拟器 ——为CI和无网络沙盒提供本地出入口替换服务.
安装
npm install @api-emulator/core
概览
该核心提供共享基础设施,每个服务插件都基于:
- 存储 普通的内存商店,有打字机
Collection<T> 支持 CRUD 、 索引、 过滤和页码
- 服务器 ——基于Hono的HTTP服务器具有自动端口管理功能
- 中间软件 ——无记名证书认证,错误处理,CORS
- 用户 共享授权/同意的页面渲染与捆绑字体
- 持久性 ——用于状态耐久性的可插接保存/装入适配器
持久性
文件持久性
对于本地开发,使用内置文件适配器:
import { filePersistence } from '@api-emulator/core'
persistence: filePersistence('.api-emulator/state.json')
自定义适配器
任何对象 load 财务报告和审定财务报表 save 方法作用:
const kvAdapter = {
async load() { return await kv.get('api-emulator-state') },
async save(data: string) { await kv.set('api-emulator-state', data) },
}
持久性适配器在冷起(负载)和每次突变请求后被调用(save). 保存通过内部排队来序列化,以防止种族条件.
链接
关于 @api-emulator/core 的常见问题
@api-emulator/core 是什么？
HTTP服务器,内存存储器,插件接口,以及相模服务插件的中间软件.
如何安装 @api-emulator/core？
在项目目录运行 npm install @api-emulator/core，或使用 pnpm add / yarn add / bun add。
@api-emulator/core 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@api-emulator/core 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@api-emulator/core 可以商用吗？
@api-emulator/core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@api-emulator/core 的下载量有多少？
根据 npm 官方下载统计，@api-emulator/core 在 2026/10/06 – 2026/11/04 这 30 天内被下载 4,429 次，日均约 148 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@api-emulator/core 还在维护吗？
最新版本 0.9.0 发布于 2026/08/12（2 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/05/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。