# @elaraai/e3-api-tests 中文文档

规范地址：https://npmcn.com/package/%40elaraai/e3-api-tests/

版本：1\.0\.107
npm 元数据更新时间：2026-11-13T06:52:53.888Z
中文译文更新时间：2026-11-13T13:16:26.973Z
软件包许可：BUSL-1\.1

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

原始 npm 页面：https://www.npmjs.com/package/%40elaraai/e3-api-tests
原文对照：https://npmcn.com/package/%40elaraai/e3-api-tests/?lang=original
项目主页：https://github.com/elaraai/east-workspace#readme
源码仓库：https://github.com/elaraai/east-workspace

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

- 包体积（解压后）：1.3 MB，119 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.2\.0
- 运行依赖：7 个
- 首次发布：2026-01-19T06:28:20.174Z
- 最新版本发布：2026-11-13T06:52:53.514Z
- 近 30 天下载量：3526（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：149（近 12 个月 149 个）

## 中文简介

东行引擎 API 达标测试 - 为e3 API 实施共享测试套件

## 安装

```sh
npm install @elaraai/e3-api-tests
```

也可以使用：`pnpm add @elaraai/e3-api-tests`、`yarn add @elaraai/e3-api-tests`、`bun add @elaraai/e3-api-tests`

## README

# @elaraai/e3-api测试

E3 API服务器的合规测试套件,用于e3 单列波的集成测试. 用于验证参考服务器( Q)`@elaraai/e3-api-server`),并确保任何替代的e3服务器执行符合相同的API合同.

## 安装

```bash
npm install @elaraai/e3-api-tests
```

## 使用量

每个测试都通过一个 `TestSetup<T>` 工厂,允许同时执行:

```typescript
import { describe, after } from 'node:test';
import { createServer } from '@elaraai/e3-api-server';
import { allApiTests, createTestContext, type TestSetup, type TestContext } from '@elaraai/e3-api-tests';

// Shared server (one per test run)
const server = await createServer({ reposDir: tempDir, port: 0 });
await server.start();

// Per-test setup: creates a fresh repo + context
const setup: TestSetup<TestContext> = async (t) => {
  const ctx = await createTestContext({
    baseUrl: `http://localhost:${server.port}`,
    getToken: async () => '',
    // No auth: a reader's token is the admin's
    getReaderToken: async () => '',
    cleanup: true,
  });
  t.after(() => ctx.cleanup());
  return ctx;
};

describe('API compliance', { concurrency: true }, () => {
  after(() => server.stop());
  allApiTests(setup);
});
```

套房叫两个叫:

-   **`getToken`是因为**,谁可以做任何事情 套房做的.
-   **`getReaderToken(repo)`是因为**,可读 `repo`还有谁的一发奖金 `platform_free`: 读者案例 `functionTests` 运行它。 服务器保持每个寄存器的访问权限的牵引器允许该呼叫器访问 `repo` 在它回复之前.

一个没有认证的服务器会回答任何符号 。 Author 需要签名或获取两个令牌,因为 `test/integration/src/api-compliance.spec.ts` 为本地服务器签名 .

服务器在自己的进程中响应请求, 如在一页中运行的 e 3 , 给 `fetch`. 套房的每一个要求随后都会经过它:客户的电话,套房自己的要求(`ctx.fetch`)和e3的平台功能. 综合测试的API合规部分`test/integration/src/compliance-parts.ts`运行套房通过一个 `fetch` 转发到本地服务器,而全局 `fetch` 拒绝每一个请求.

服务器不运行命令( 例如 e3 在页面中运行) 的牵引装置 `commands: false`。套房的任务为East,每个服务器运行,其失败的任务在East失败:每个都被记录 `failed`,退出代码1,其信息输入其 stderr 日志。 1个案件在 `dataflowTests` 运行一个命令,一个自定义任务退出 1 。 在运行命令的服务器上,它期望完成此任务 `failed`,退出代码 1;在不运行时,记录 `error`,有一条消息说服务器没有运行命令.

## 出口

| 导出 | 说明 |
| --- | --- |
| `TestSetup<T>` | 每个试验背景厂的类型 : `(t: TestContext) => Promise<T>` |
| `createTestContext` | 创建设置/ 隐藏的测试上下文 |
| `allApiTests` | 注册每个 API 测试套件 `apiTestSuites`:寄存器,软件包,工作空间,数据集,数据集页面,数据集传输,数据流,功能,记录,密钥记录,记录部署,软件包传输和平台 |
| `apiTestSuites` | 每个 API 测试套件名称, 按顺序 `allApiTests` 登记它们:一个将它们按部件运行的管子,并检查每个部件名称 |
| `allTests` | 登记所有测试,包括CLI测试(需要证书) |
| `repositoryTests` | 仓库 CRUD 测试 |
| `packageTests` | 包进出口试验 |
| `workspaceTests` | 工作空间管理测试 |
| `datasetTests` | 数据集读取/写入测试 |
| `datasetPageTests` | 页面数据集已读取并按键搜索 |
| `datasetTransferTests` | 通过传输协议上传和下载数据集 |
| `dataflowTests` | 数据流执行测试 |
| `functionTests` | 函数调用,一发和分拨调用,作为管理员和读者 |
| `recordTests` | 记录突变 |
| `keyedRecordTests` | 密钥记录: 每个写入表单及其索引 |
| `recordDeployTests` | 不同部署的记录:迁移 |
| `packageTransferTests` | 一揽子进出口作为工作 |
| `platformTests` | 平台能力测试 |
| `cliTests` | CLI 整合测试 |
| `transferTests` | 交叉存储器转移测试 |
| `createPackageZip` | 创建测试包 zip 文件 |
| `runE3Command` | 运行 e3 CLI 命令 |

## Claude 代码插件

东方生态系统也运载a [克劳德代码](https://claude.com/claude-code) 插件 — East 语言技能, 实例搜索, 以及 East 代码的先发制人诊断 `elaraai` 市场:

```text
# Inside Claude Code
/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai
```

```bash
# From a terminal
claude plugin marketplace add elaraai/east-workspace
claude plugin install east@elaraai
```

## 许可证

BSL 1.1. 见 [利比里亚](https://npmcn.com/package/%40elaraai/e3-api-tests/LICENSE.md)。 。 。 .

### 生态系统

-   **[东](https://github.com/elaraai/east-workspace/tree/main/libs/east)**: statical地打出,以表达为主的语言有可序列的IR. 运行跨 TypeScript, Python, C 等运行时间的可移植逻辑.
    
    -   [@elaraai/东边](https://www.npmjs.com/package/@elaraai/east): 有类型系统、表达式和参考JS编译器的核心语言SDK
-   **[东节点](https://github.com/elaraai/east-workspace/tree/main/libs/east-node)**: Node.js 平台用于I/O,数据库和系统操作的功能.
    
    -   [@elaraai/东节点-std](https://www.npmjs.com/package/@elaraai/east-node-std): 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   [@elaraai/东-北-欧](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, 压缩
    -   [@elaraai/东-节点-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): 用于在 Node.js 运行 East IR 程序的 CLI
-   **[东 C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11本土运行时间用于执行东IR. 通过npm(发射器+每个平面的可选依赖)进行分配,并在每个GitHub放出上作为tarball.
    
    -   [@elaraai/东-克-克利](https://www.npmjs.com/package/@elaraai/east-c-cli): npm 发射器 – 安装匹配的本地二进制作为可选依赖
    -   `east-c`: Core 运行时间 – 类型系统,IR 解释器,内置,序列化(Beast2, JSON, CSV, East text)
    -   `east-c-std`: 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   `east-c-cli`: 用于在本地运行 East IR 程序的 CLI
-   **[东 Py](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)**: Python 运行时间,标准平台,I/O,以及数据科学平台功能. 发布至PyPI.
    
    -   [东平](https://pypi.org/project/east-py/): Core Python 运行时间——类型系统,IR编译器,212+内建,Cython加速热路
    -   [东平-上](https://pypi.org/project/east-py-std/): 控制台、 文件系统、 获取、 加密、 时间、 路径、 随机
    -   [东比欧](https://pypi.org/project/east-py-io/): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, 压缩
    -   [东-平-克利](https://pypi.org/project/east-py-cli/): 用于在 Python 运行 East IR 程序的 CLI
    -   [东平数据科学](https://pypi.org/project/east-py-datascience/) (平价)+ [@elaraai/东平数据科学](https://www.npmjs.com/package/@elaraai/east-py-datascience) (npm):优化(MADS, Optuna, ALNS, GoogleOR),ML(XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), 贝叶斯推论(PyMC),可解释性(SHAP),相通性预测(MAPIE)
-   **[东方大学](https://github.com/elaraai/east-workspace/tree/main/libs/east-ui)**:已打入UI组件定义和React渲染器,外加VS代码预览.
    
    -   [@elaraai/东-伊](https://www.npmjs.com/package/@elaraai/east-ui): 50+ 键入的UI 组件用于布局,窗体,图表,表格,对话框
    -   [@elaraai/ 东- ui- 组件](https://www.npmjs.com/package/@elaraai/east-ui-components): 带有 Chakra UI v3 样式的反相渲染器
    -   [@elaraai/e3-ui (英语)](https://www.npmjs.com/package/@elaraai/e3-ui):e3 + UI桥-数据绑定, `e3.ui()` 任务,显示
    -   [@elaai/e3-ui-组件](https://www.npmjs.com/package/@elaraai/e3-ui-components): 为 e3 API 执行查询钩和预览组件
-   **[e3——东行发动机](https://github.com/elaraai/east-workspace/tree/main/libs/e3)**: 大规模运行东方管线的持久执行引擎。 类似Git的内容可处理存储,自动记忆,反应数据流,实时监测.
    
    -   [@elaraai/e3 请检查url=值 (帮助)](https://www.npmjs.com/package/@elaraai/e3): SDK 用于编写带有打字任务和管道的 E3 包
    -   [@elaraai/e3-core (英语)](https://www.npmjs.com/package/@elaraai/e3-core): 对象存储、数据流管弦器、执行状态
    -   [@elaai/e3型](https://www.npmjs.com/package/@elaraai/e3-types): e3 包的共享类型定义
    -   [@elaraai/e3-cli (英语)](https://www.npmjs.com/package/@elaraai/e3-cli)数字 : `e3 repo`, (中文(简体) ), `e3 package`, (中文(简体) ), `e3 workspace`, (中文(简体) ), `e3 dataflow run`, (中文(简体) ), `e3 watch`, (中文(简体) ), `e3 task logs` 命令
    -   [@elaraai/e3-api-客户端](https://www.npmjs.com/package/@elaraai/e3-api-client)远程 e3 寄存器的 HTTP 客户端
    -   [@elaraai/e3-api-服务器](https://www.npmjs.com/package/@elaraai/e3-api-server): 用于 e3 寄存器的 REST API 服务器
    -   [@elaraai/e3-api测试](https://www.npmjs.com/package/@elaraai/e3-api-tests): 共享 API 合规测试套件

## 链接

-   [东方语言](https://github.com/elaraai/east-workspace/tree/main/libs/east)
-   [东 Python 运行时间](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)
-   [Elara 大赦国际](https://elaraai.com/)
-   [问题](https://github.com/elaraai/east-workspace/issues)
-   [支助@elara.ai](mailto:support@elara.ai)

## 关于埃拉拉

东方由 [Elara AI Pty有限公司](https://elaraai.com/)一个由AI驱动的平台 创造经济数字双胞胎 企业优化业绩。 Elara将业务目标、决定和数据结合起来,以帮助各组织在业务、采购、销售和客户参与以及项目和投资规划方面作出由数据驱动的决定。 东能给以埃拉拉解决方案的计算层,使得复杂的商业逻辑和数据能够以简单,类型安全和可移植的语言来表达.

* * *

_开发者 [Elara AI Pty有限公司](https://elaraai.com/)。 。 。 ._

* * *

_开发者 [Elara AI Pty有限公司](https://elaraai.com/)_

## 常见问题

### @elaraai/e3-api-tests 是什么？

东行引擎 API 达标测试 - 为e3 API 实施共享测试套件

### 如何安装 @elaraai/e3-api-tests？

在项目目录运行 npm install @elaraai/e3-api-tests，或使用 pnpm add / yarn add / bun add。

### @elaraai/e3-api-tests 支持 TypeScript 吗？

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

### @elaraai/e3-api-tests 支持 ESM 还是 CommonJS？

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

### @elaraai/e3-api-tests 需要什么版本的 Node\.js？

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

### @elaraai/e3-api-tests 可以商用吗？

@elaraai/e3-api-tests 使用 BUSL-1\.1 许可。声明的许可为 BUSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @elaraai/e3-api-tests 的下载量有多少？

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

### @elaraai/e3-api-tests 还在维护吗？

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