# @atomic-testing/core 中文文档

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

版本：0\.104\.0
npm 元数据更新时间：2026-08-20T13:17:28.293Z
中文译文更新时间：2026-11-07T03:24:26.083Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：951 kB，94 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2023-03-08T03:41:44.466Z
- 最新版本发布：2026-08-20T13:17:27.876Z
- 近 30 天下载量：16397（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 22 个）

## 中文简介

原子测试核心库

## 安装

```sh
npm install @atomic-testing/core
```

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

## README

# @ 原子测试/ 核心

[![NPM version](https://img.shields.io/npm/v/@atomic-testing/core.svg?style=flat)](https://www.npmjs.com/package/@atomic-testing/core) ![NPM license](https://img.shields.io/npm/l/@atomic-testing/core.svg?style=flat)

为整个原子测试生态系统提供动力的核心设施。 包裹 定义用于模拟场景、定位元素和与 跨越不同测试环境的组件.

> **最快的开始 :** 运行 `npm create atomic-testing@latest` 要脚手架一个工作 测试设置——跑道配置,示例组件,其 `ScenePart` 和传球 测试——输入一个现有项目.

原子试验旨在提供一种一致的方式与 跨越DOM和端到端测试的第三方或一方组件. 核心内容 重点 **可续用性**, (中文(简体) ), **可替换性**,以及 **适应性** 所以一样 测试可以在React,Vue,Playwright,Cypress等网站运行.

## 关键特性

-   **构成部分** - 与UI组件进行程序互动。 司机 显示高水平动作, 如点击按钮或读取一个值 .
-   **定位器** - 使用辅助工具查找元素,例如 `byDataTestId` 或者说 `byRole`。 。 。 .
-   **场景部件** - 将页面或部件的片段描述为驱动程序地图.
-   **测试引擎** - 制作一个场景,并允许访问所有定义的部分,这样 试验仍可忽略基本框架.

## 示例

```tsx
import { TextFieldDriver, ButtonDriver } from '@atomic-testing/component-driver-mui-v6';
import { byDataTestId, ScenePart } from '@atomic-testing/core';
import { createTestEngine } from '@atomic-testing/react-19';

import { Login } from './Login';

const loginScenePart = {
  username: { locator: byDataTestId('username'), driver: TextFieldDriver },
  password: { locator: byDataTestId('password'), driver: TextFieldDriver },
  submit: { locator: byDataTestId('submit'), driver: ButtonDriver },
} satisfies ScenePart;

const engine = createTestEngine(<Login />, loginScenePart);
await engine.parts.username.setValue('alice');
await engine.parts.password.setValue('secret');
await engine.parts.submit.click();
await engine.cleanUp();
```

参见 [文档](https://atomic-testing.dev/) 详细指南 和更多的例子。 完整的注册窗体示例可见于 `examples/example-mui-signup-form`。 。 。 .

## 公共 API 稳定性

这个包的稳定表面是它的 `.` 桶出口,在 由被害者进行机器检查 [API 提取器](https://api-extractor.com/) 报告 [`etc/core.api.md`](https://github.com/atomic-testing/atomic-testing/blob/main/packages/core/etc/core.api.md)。标记的出口 `@internal` 为: 不是保证的一部分。 见 [1.0 API 冻结和演变政策](https://github.com/atomic-testing/atomic-testing/blob/main/agent-docs/adr/006-1.0-api-freeze-and-evolution.md)。 。 。 .

## 常见问题

### @atomic-testing/core 是什么？

原子测试核心库

### 如何安装 @atomic-testing/core？

在项目目录运行 npm install @atomic-testing/core，或使用 pnpm add / yarn add / bun add。

### @atomic-testing/core 支持 TypeScript 吗？

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

### @atomic-testing/core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @atomic-testing/core 可以商用吗？

@atomic-testing/core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @atomic-testing/core 的下载量有多少？

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

### @atomic-testing/core 还在维护吗？

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