npm 包 gemini 使用教程

阅读时长 3 分钟读完

在前端开发中,我们经常需要进行 UI 自动化测试。gemini 是一个基于 Node.js 的 UI 测试框架,可以用于进行前端组件的视觉回归测试和功能测试,它支持多种浏览器和 Node.js 版本,并且可以与不同的测试运行器和断言库进行集成。本文将介绍 gemini 的基本使用方法与相关技巧。

安装

首先,我们需要通过 npm 安装 gemini 和相关依赖:

其中:

  • gemini 是核心包;
  • gemini-resemble 是用于生成图片差异的 reporter;
  • compare-images 是用于比较两张图片的库。

同时,安装一个浏览器驱动程序,比如 chrome,以此作为 gemini 的测试浏览器。

配置

在项目根目录下新建一个 .gemini.yml 配置文件,内容如下:

-- -------------------- ---- -------
-------- ---------------------
-----
  ----
    ------ --------------------------
    ---------
      - ------
-------
  ------ ----
  --------
    ------
      ----- --------------------

其中:

  • rootUrl 是项目的根路径,用于定义测试网站的 base url;
  • sets 则定义了测试集合,包括测试文件地址和测试浏览器;
  • system 则是一些其他配置,比如开启调试模式和添加插件等。

示例

下面是一个 gemini 测试案例,测试一个按钮样式的正确性:

-- -------------------- ---- -------
-------------- - -------- -------- -
  ---------------------- -------- ------- -
    ------------------------------------
      ------------------------------
      ------------------------------------
      -----------------
      ------------------- -------- --------- ----- -
        -----------------------------------
      ---
  ---
--

其中:

  • module.exports 导出一个函数,该函数接收一个 gemini 实例;
  • gemini.suite 表示一套测试单元,可以通过传入 path, setNamebisers 参数来配置;
  • suite.setUrl 表示测试的页面地址;
  • suite.setCaptureElements 表示需要捕获的元素选择器,可以使用多个命名捕获区域,这里分别是正常状态和鼠标悬停状态;
  • suite.capture 则是具体的测试动作,包括捕获元素和生成对比图片等。

运行

首先需要启动被测试项目的本地服务器,并在控制台中输入命令:

该命令会自动加载配置文件,并执行测试用例,如果有失败的用例会在控制台中输出详细的信息和截图。

小结

本文介绍了 gemini 的基本使用方法与相关技巧,包括安装和配置,测试示例和运行等,希望对前端开发者在进行 UI 自动化测试时能有所帮助。更多使用方式和实战经验可以到 gemini 官网和社区进行查阅。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/68477

纠错
反馈