# @api-emulator/core 中文文档

规范地址：https://npmcn.com/package/%40api-emulator/core/

版本：0\.9\.0
npm 元数据更新时间：2026-08-11T20:27:58.650Z
中文译文更新时间：2026-11-06T09:41:19.680Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40api-emulator/core
原文对照：https://npmcn.com/package/%40api-emulator/core/?lang=original
项目主页：https://api-emulator.jsj.sh/
源码仓库：https://github.com/jsj/api-emulator

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：221 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-05-12T01:25:39.171Z
- 最新版本发布：2026-08-11T20:27:58.364Z
- 近 30 天下载量：4429（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

HTTP服务器,内存存储器,插件接口,以及相模服务插件的中间软件.

## 安装

```sh
npm install @api-emulator/core
```

也可以使用：`pnpm add @api-emulator/core`、`yarn add @api-emulator/core`、`bun add @api-emulator/core`

## README

# @ api- 模拟器/ 核心

HTTP服务器,内存存储器,插件接口,以及相模服务插件的中间软件.

部分 [模拟器](https://github.com/jsj/api-emulator) ——为CI和无网络沙盒提供本地出入口替换服务.

## 安装

```bash
npm install @api-emulator/core
```

## 概览

该核心提供共享基础设施,每个服务插件都基于:

-   **存储** 普通的内存商店,有打字机 `Collection<T>` 支持 CRUD 、 索引、 过滤和页码
-   **服务器** ——基于Hono的HTTP服务器具有自动端口管理功能
-   **中间软件** ——无记名证书认证,错误处理,CORS
-   **用户** 共享授权/同意的页面渲染与捆绑字体
-   **持久性** ——用于状态耐久性的可插接保存/装入适配器

## 持久性

### 文件持久性

对于本地开发,使用内置文件适配器:

```typescript
import { filePersistence } from '@api-emulator/core'

persistence: filePersistence('.api-emulator/state.json')
```

### 自定义适配器

任何对象 `load` 财务报告和审定财务报表 `save` 方法作用:

```typescript
const kvAdapter = {
  async load() { return await kv.get('api-emulator-state') },
  async save(data: string) { await kv.set('api-emulator-state', data) },
}
```

持久性适配器在冷起(负载)和每次突变请求后被调用(save). 保存通过内部排队来序列化,以防止种族条件.

## 链接

-   [完整文档](https://api-emulator.jsj.sh/)
-   [GitHub 图像](https://github.com/jsj/api-emulator)

## 常见问题

### @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 和提交记录判断。