@ephox/agar

中文文档
10.0.0发布于 2026/03/31GPL-2.0-or-laterTypeScriptESM + CJS近 30 天下载 1.7万

测试基础设施

中文使用文档
文档目录3 节
  1. 从 npm 安装
  2. 运行浏览器测试
  3. 运行 Webdriver 测试

说明

agar 是一个包含测试基础设施的库 键盘, (中文(简体) ), 鼠标, (中文(简体) ), 焦点,以及 DOM 操纵它旨在提供一条管道,以便共同组成同步测试作业。 它没有捆绑任何命令。 这只是一组模块.

安装

agar 可作为 npm 软件包。 您可以通过 npm 软件包安装 @ephox/agar

从 npm 安装

npm install @ephox/agar

使用量

如前所言, agar 包含测试基础设施 键盘, (中文(简体) ), 鼠标, (中文(简体) ), 焦点,以及 DOM 操纵。查看项目目录中提供的演示的最佳地点是: src/demo/js/ephox/agar/demo今后将提供更完整的公开文件.

运行测试

agar 用途 bedrock 进行测试。 这被包装为: agar。测试有两种类型:

  • 浏览器测试
  • 网络司机测试

默认 yarn test 命令只是使用 Chrome。 。 。 .

运行浏览器测试

浏览器测试在 src/test/js/browser 目录。 它们不需要网络司机,可以使用 bedrock 模式(而不是 bedrock-auto) (中文(简体) ).

$ bedrock --testdir src/test/js/browser

在这种模式下,基德不会打开浏览器,也不会关闭. 此模式用于开发和调试.

运行 Webdriver 测试

一些Agar测试需要访问原始的 WebDriver API 如 sendKeys。这允许测试使用硒提供实际 真实 关键事件,而不是模拟JavaScript事件. 然而,要进行这些测试,你需要使用 bedrock-auto。这些测试储存在 src/test/js/webdriver 目录.

例如,在Chrome进行测试:

$ bedrock-auto -b chrome --testdir src/test/js/webdriver

版本与发布记录

@ephox/agar 共发布 149 个版本,首次发布于 2016/12/20;过去 12 个月发布了 1 个版本。

版本发布日期距今
10.0.0latest2026/03/317 个月前
8.0.12024/02/072 年前
8.0.02023/11/222 年前
8.0.0-alpha.02023/11/103 年前
7.4.42023/10/253 年前
7.4.32023/06/123 年前

其他发布通道:rc → 7.1.0-alpha.1,legacy → 6.0.4。

关于 @ephox/agar 的常见问题

@ephox/agar 是什么?

测试基础设施

如何安装 @ephox/agar?

在项目目录运行 npm install @ephox/agar,或使用 pnpm add / yarn add / bun add。

@ephox/agar 支持 TypeScript 吗?

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

@ephox/agar 支持 ESM 还是 CommonJS?

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

@ephox/agar 可以商用吗?

@ephox/agar 使用 GPL-2.0-or-later 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

@ephox/agar 的下载量有多少?

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

@ephox/agar 还在维护吗?

最新版本 10.0.0 发布于 2026/03/31(7 个月前);至今共发布 149 个版本,其中过去 12 个月发布了 1 个;首次发布于 2016/12/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。