# @getaster/mock 中文文档

规范地址：https://npmcn.com/package/%40getaster/mock/

版本：0\.4\.72
npm 元数据更新时间：2026-11-16T01:15:29.601Z
中文译文更新时间：2026-11-16T05:52:14.811Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40getaster/mock
原文对照：https://npmcn.com/package/%40getaster/mock/?lang=original
项目主页：https://ui.getaster.now/docs/guide/library.html
源码仓库：https://github.com/GetAster/aster-ui

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

- 包体积（解压后）：5.9 MB，84 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-10-21T10:23:24.160Z
- 最新版本发布：2026-11-16T01:15:29.233Z
- 近 30 天下载量：3346（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

本地OData模拟服务由WebAssembly提供,用于Aster UI测试和演示.

## 安装

```sh
npm install @getaster/mock
```

也可以使用：`pnpm add @getaster/mock`、`yarn add @getaster/mock`、`bun add @getaster/mock`

## README

# @ getaster/ mock (中文(简体) )

本地OData服务,用于Aster UI开发,实例和集成测试. 该服务在WebAssembly中运行,并曝光所使用的同一运输界面 以 `@getaster/data`,因此测试可以进行元数据、查询和写作,而无需 启动 HTTP 服务器 .

用于开发、实例和测试;生产应用程序连接 给自己的OData服务.

## 安装

```sh
npm install @getaster/data
npm install --save-dev @getaster/mock
```

该软件包包括其WebAssembly二进制和许可通知. 没有 Rust 编译器 或安装脚本。 它提供ES模块和类型脚本声明; 节点.js的使用需要节点22或更晚. 浏览器构建必须服务于 WASM 资产 超过HTTP或明确通过它的字节.

### WASM 位置和浏览器路由

发动机是 `wasm/odata_mock.wasm` 在安装的软件包内。 包裹 导出文件, 所以 `import.meta.resolve('@getaster/mock/wasm/odata_mock.wasm')` 返回其在 Node.js 和 Bun 中的位置.

一个浏览器页面一般会通过一个URL,让开发服务器为它服务. 记录的公约是根相通的路线:

```js
const mock = await createMockService({
  metadata, data,
  wasm: new URL('odata_mock.wasm', document.baseURI),
});
```

服务器必须在 `/odata_mock.wasm`数字 :

```js
import { fileURLToPath } from 'node:url';
const wasm = Bun.file(fileURLToPath(import.meta.resolve('@getaster/mock/wasm/odata_mock.wasm')));

Bun.serve({
  port: 4200,
  routes: {
    '/odata_mock.wasm': () => new Response(wasm, { headers: { 'content-type': 'application/wasm' } }),
  },
});
```

`apps/showcase/serve.ts` 为寄存器演示执行此路由,以及 `scripts/verify-wasm.ts` 检查二进制的校验和、模块和归属 文件在分发前。 过 `wasm` 字节, a `URL` 或者一个 URL 字符串代替 当文件生活在别处时;它的默认值是包相关联文件.

## 在 Node.js 运行本地服务

使用此节点的 TypeScript 项目也需要 `@types/node` 作为 发展依赖.

```ts
import { readFileSync } from 'node:fs';
import { DataContext } from '@getaster/data';
import { createMockService } from '@getaster/mock';

const metadata = {
  $Version: '4.01',
  $EntityContainer: 'Demo.Container',
  Demo: {
    Project: {
      $Kind: 'EntityType', $Key: ['id'],
      id: { $Type: 'Edm.Int32' },
      name: { $Type: 'Edm.String' },
    },
    Container: {
      $Kind: 'EntityContainer',
      Projects: { $Collection: true, $Type: 'Demo.Project' },
    },
  },
};
const wasm = readFileSync(new URL(
  import.meta.resolve('@getaster/mock/wasm/odata_mock.wasm')
));
const mock = await createMockService({
  metadata, wasm,
  data: { Projects: [{ id: 1, name: 'First project' }] },
});
const ctx = await DataContext.connect(mock.transport);
const projects = ctx.collection({ set: 'Projects' });
try {
  await projects.view(0, 10);
  if (projects.error.value) throw projects.error.value;
  console.log(projects.items.value);
} finally {
  ctx.release(projects);
}
```

## 练习应用行为

`mock.faults.latencyMs` 财务报告和审定财务报表 `writeLatencyMs` 模拟慢请求; `mock.faults.failNext(503)` 失败下一个运输请求 。 使用 `mock.external()` 以模拟另一个用户的写作和测试 stale 编辑。 ETags为不透明值: 保存并归还,而不是在试验中建造.

数字是默认准确的。 可选 `countEstimate` 设置模拟 用于客户端测试的估计生成服务; 这不是 Web Data 的正常数 行为。 可选存储支持持久性; `dump()`, (中文(简体) ), `flush()` 财务报告和审定财务报表 `reset()` 让测试控制状态。 工人帮助器可供浏览器使用.

## 文件和支助

-   [安装和分发](https://ui.getaster.now/docs/guide/library.html)
-   [工作浏览器示例](https://ui.getaster.now/docs/guide/getting-started.html)
-   [API 参考](https://ui.getaster.now/docs/reference/)
-   [报告错误](https://github.com/GetAster/aster-ui/issues)

## 许可证

Aster UI 根据 Apache- 2. 0 获得许可; 参见 `LICENSE` 财务报告和审定财务报表 `NOTICE`选项 模拟引擎作为Apache-2.0 许可的Web Assembly 二进制提供;其 不包括执行来源。 保留包装的第三方部件 他们各自的执照。 他们的归属清单在 `wasm/NOTICE`,与 许可证文本 `wasm/licenses/`。在重新分配时保存这些文件 二进制.

## 常见问题

### @getaster/mock 是什么？

本地OData模拟服务由WebAssembly提供,用于Aster UI测试和演示\.

### 如何安装 @getaster/mock？

在项目目录运行 npm install @getaster/mock，或使用 pnpm add / yarn add / bun add。

### @getaster/mock 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @getaster/mock 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @getaster/mock 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @getaster/mock 可以商用吗？

@getaster/mock 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @getaster/mock 的下载量有多少？

根据 npm 官方下载统计，@getaster/mock 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,346 次，日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @getaster/mock 还在维护吗？

最新版本 0\.4\.72 发布于 2026/11/16（今天）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/10/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

