@ 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/。在重新分配时保存这些文件
二进制.