@atomic-testing/core

中文文档
0.104.0发布于 2026/08/20MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 1.6万

原子测试核心库

中文使用文档
文档目录3 节
  1. 关键特性
  2. 示例
  3. 公共 API 稳定性

@ 原子测试/ 核心

NPM version NPM license

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

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

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

关键特性

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

示例

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();

参见 文档 详细指南 和更多的例子。 完整的注册窗体示例可见于 examples/example-mui-signup-form。 。 。 .

公共 API 稳定性

这个包的稳定表面是它的 . 桶出口,在 由被害者进行机器检查 API 提取器 报告 etc/core.api.md。标记的出口 @internal 为: 不是保证的一部分。 见 1.0 API 冻结和演变政策。 。 。 .

版本与发布记录

@atomic-testing/core 共发布 102 个版本,首次发布于 2023/03/08;过去 12 个月发布了 22 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.104.0latest2026/08/202 个月前
0.103.02026/08/182 个月前
0.102.02026/08/172 个月前
0.101.02026/08/073 个月前
0.100.02026/08/023 个月前
0.99.02026/07/223 个月前

关于 @atomic-testing/core 的常见问题

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