@getaster/mock

中文文档
0.4.72发布于 2026/11/16Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 3346

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

中文使用文档
文档目录6 节
  1. 安装
  2. WASM 位置和浏览器路由
  3. 在 Node.js 运行本地服务
  4. 练习应用行为
  5. 文件和支助
  6. 许可证

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

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

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

安装

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,让开发服务器为它服务. 记录的公约是根相通的路线:

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

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

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 作为 发展依赖.

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() 让测试控制状态。 工人帮助器可供浏览器使用.

文件和支助

许可证

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

版本与发布记录

@getaster/mock 共发布 20 个版本,首次发布于 2026/10/21;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.72latest2026/11/16今天
0.4.472026/11/141 天前
0.4.422026/11/133 天前
0.4.402026/11/133 天前
0.4.382026/11/123 天前
0.4.352026/11/123 天前

其他发布通道:next → 0.1.0-preview.1。

关于 @getaster/mock 的常见问题

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