使用 Jest 作为测试运行器

概述

Jest 是一个 JavaScript 测试框架，用于轻松编写单元测试，而 Nightwatch.js 是一个集成测试框架，用于在所有主要浏览器上对 Web 应用程序和网站执行自动化的端到端测试。

因此，为了同时使用 Jest 和 Nightwatch 的功能，Nightwatch 引入了一个新的依赖项 jest-environment-nightwatch。

API

global.browser

Nightwatch 浏览器 API 对象。当 autoStartSession 关闭时不可用。

global.jestNightwatch

Jest 环境使用 Nightwatch 编程 API 创建 Nightwatch 实例并导出浏览器 API。

可用属性/方法

• .element(<locator>) - 使用 Nightwatch .element() API 在页面中查找元素；

• .updateCapabilities({ capabilities }) - 当 autoStartSession 关闭时使用，以便在运行时更新功能；

• .launchBrowser() - 当 autoStartSession 关闭时使用，以便启动会话并打开浏览器；

• .settings - Nightwatch 设置对象；

• .nightwatch_client - Nightwatch（内部）实例。

配置和示例

步骤 0：安装 Nightwatch

按照 指南 或观看 视频 从头开始安装 Nightwatch。

步骤 1：安装 Jest

npm i jest --save-dev

并确保在 package.json 文件中包含以下脚本，以便运行 Jest 测试。

{
 "scripts": {
   "test": "jest"
 }
}

步骤 2：安装和配置 jest-environment-nightwatch 包

为了将 Nightwatch 与 Jest 配合使用，您需要安装 jest-environment-nightwatch。安装 Jest 和测试所需的其它依赖项。

npm i jest-environment-nightwatch --save-dev

Nightwatch Jest 环境带有默认设置。但是，如果需要，可以调整 Jest 配置

{
  testEnvironment: 'jest-environment-nightwatch',
  testEnvironmentOptions: {
    // Nightwatch related options
    headless: true,
    browserName: 'chrome',
    baseUrl: '',
    verbose: false,  
    output: true,
    env: null, 
    parallel: false,
    devtools: false,
    debug: false,
    autoStartSession: true,
    persistGlobals: true,
    configFile: './nightwatch.conf.js',
    globals: {}, 
    webdriver: {},
    timeout: null,
    enableGlobalApis: false,
    alwaysAsync: true,
    desiredCapabilities: {},
    async setup(browser) {},
    async teardown(browser) {},
  },
  

  testMatch: [
      "**/tests/*.[jt]s?(x)"
   ],
}

您可以在 testMatch 中设置测试文件夹目录。

Nightwatch 选项

通过提供以下任何配置选项可以修改 Nightwatch 的默认行为。以下是可用选项及其默认值的列表。

步骤 3：运行示例测试

考虑以下示例测试

describe('duckduckgo example', function() {
  it('Search Nightwatch.js and check results', function(browser) {
    browser
      .navigateTo('https://duckduckgo.com')
      .waitForElementVisible('#search_form_input_homepage')
      .sendKeys('#search_form_input_homepage', ['Nightwatch.js'])
      .click('#search_button_homepage')
      .assert.visible('.results--main')
      .assert.textContains('.results--main', 'Nightwatch.js');
  }); 
});

注意：Jest 对钩子有不同的命名约定，因此您应该确认您的测试遵循本指南。*

步骤 4：查看 Jest 测试运行器的结果

相关文章

• 操作指南 > 编写测试 > 使用 Jest 作为测试运行器
• 操作指南 > 编写测试 > 使用 Mocha 作为测试运行器