组织测试套件

随着项目的增长，集成测试不可避免地会越来越多。这会增加构建时间并降低生产效率。

为了防止这种情况，你应该并行运行测试。WebdriverIO已经在单个会话中并行测试每个规格文件（或Cucumber中的_特性文件_）。通常，尽量在每个规格文件中只测试一个功能。尽量不要在一个文件中包含太多或太少的测试。（然而，这里没有黄金法则。）

一旦你的测试有了多个规格文件，你应该开始并发运行测试。要做到这一点，请调整配置文件中的maxInstances属性。WebdriverIO允许你以最大并发度运行测试——这意味着无论你有多少文件和测试，它们都可以并行运行。（这仍然受到一定限制，比如你的计算机CPU、并发限制等。）

假设你有3种不同的能力（Chrome、Firefox和Safari），并且你将maxInstances设置为1。WDIO测试运行器将生成3个进程。因此，如果你有10个规格文件，并且将maxInstances设置为10，_所有_规格文件将同时测试，并且将生成30个进程。

你可以全局定义maxInstances属性，为所有浏览器设置该属性。

如果你运行自己的WebDriver网格，你可能（例如）对一个浏览器的容量比另一个更多。在这种情况下，你可以在你的能力对象中_限制_maxInstances：

// wdio.conf.js
export const config = {
    // ...
    // set maxInstance for all browser
    maxInstances: 10,
    // ...
    capabilities: [{
        browserName: 'firefox'
    }, {
        // maxInstances can get overwritten per capability. So if you have an in-house WebDriver
        // grid with only 5 firefox instance available you can make sure that not more than
        // 5 instance gets started at a time.
        browserName: 'chrome'
    }],
    // ...
}

继承主配置文件

如果你在多个环境（例如开发和集成）中运行测试套件，使用多个配置文件可能有助于保持管理。

类似于页面对象概念，首先你需要一个主配置文件。它包含你在环境之间共享的所有配置。

然后为每个环境创建另一个配置文件，并用特定环境的配置补充主配置：

// wdio.dev.config.js
import { deepmerge } from 'deepmerge-ts'
import wdioConf from './wdio.conf.js'

// have main config file as default but overwrite environment specific information
export const config = deepmerge(wdioConf.config, {
    capabilities: [
        // more caps defined here
        // ...
    ],

    // run tests on sauce instead locally
    user: process.env.SAUCE_USERNAME,
    key: process.env.SAUCE_ACCESS_KEY,
    services: ['sauce']
}, { clone: false })

// add an additional reporter
config.reporters.push('allure')

在套件中分组测试规格

你可以将测试规格分组到套件中，并运行单个特定套件而不是全部运行。

首先，在你的WDIO配置中定义你的套件：

// wdio.conf.js
export const config = {
    // define all tests
    specs: ['./test/specs/**/*.spec.js'],
    // ...
    // define specific suites
    suites: {
        login: [
            './test/specs/login.success.spec.js',
            './test/specs/login.failure.spec.js'
        ],
        otherFeature: [
            // ...
        ]
    },
    // ...
}

现在，如果你只想运行单个套件，你可以将套件名称作为CLI参数传递：

wdio wdio.conf.js --suite login

或者，一次运行多个套件：

wdio wdio.conf.js --suite login --suite otherFeature

分组测试规格以顺序运行

如上所述，并发运行测试有很多好处。然而，在某些情况下，将测试分组在一个实例中顺序运行会有益处。这方面的例子主要是在有大量设置成本的情况下，例如转译代码或配置云实例，但也有一些高级使用模型从这种功能中受益。

要将测试分组在单个实例中运行，请在specs定义中将它们定义为数组。

    "specs": [
        [
            "./test/specs/test_login.js",
            "./test/specs/test_product_order.js",
            "./test/specs/test_checkout.js"
        ],
        "./test/specs/test_b*.js",
    ],

在上面的例子中，测试'test_login.js'，'test_product_order.js'和'test_checkout.js'将在单个实例中顺序运行，而每个"test_b*"测试将在独立的实例中并发运行。

也可以对套件中定义的规格进行分组，所以你现在也可以这样定义套件：

    "suites": {
        end2end: [
            [
                "./test/specs/test_login.js",
                "./test/specs/test_product_order.js",
                "./test/specs/test_checkout.js"
            ]
        ],
        allb: ["./test/specs/test_b*.js"]
},

在这种情况下，"end2end"套件的所有测试都将在单个实例中运行。

使用模式顺序运行测试时，它将按字母顺序运行规格文件

  "suites": {
    end2end: ["./test/specs/test_*.js"]
  },

这将按以下顺序运行与上述模式匹配的文件：

  [
      "./test/specs/test_checkout.js",
      "./test/specs/test_login.js",
      "./test/specs/test_product_order.js"
  ]

运行选定的测试

在某些情况下，你可能只希望执行套件中的单个测试（或测试子集）。

使用--spec参数，你可以指定应该运行哪个_套件_（Mocha, Jasmine）或_特性_（Cucumber）。路径相对于你当前的工作目录解析。

例如，只运行你的登录测试：

wdio wdio.conf.js --spec ./test/specs/e2e/login.js

或者一次运行多个规格：

wdio wdio.conf.js --spec ./test/specs/signup.js --spec ./test/specs/forgot-password.js

如果--spec值不指向特定的规格文件，则会用它来过滤配置中定义的规格文件名。

要运行规格文件名中包含"dialog"一词的所有规格，可以使用：

wdio wdio.conf.js --spec dialog

请注意，每个测试文件都在单个测试运行器进程中运行。由于我们不会提前扫描文件（有关将文件名通过管道传输到wdio的信息，请参见下一部分），你_不能_（例如）在规格文件顶部使用describe.only来指示Mocha只运行那个套件。

此功能将帮助你实现相同的目标。

提供--spec选项时，它将覆盖配置或能力级别的specs参数定义的任何模式。

排除选定的测试

在需要时，如果你需要从运行中排除特定的规格文件，你可以使用--exclude参数（Mocha, Jasmine）或特性（Cucumber）。

例如，从测试运行中排除你的登录测试：

wdio wdio.conf.js --exclude ./test/specs/e2e/login.js

或者，排除多个规格文件：

wdio wdio.conf.js --exclude ./test/specs/signup.js --exclude ./test/specs/forgot-password.js

或者，在使用套件过滤时排除规格文件：

wdio wdio.conf.js --suite login --exclude ./test/specs/e2e/login.js

如果--exclude值不指向特定的规格文件，则会用它来过滤配置中定义的规格文件名。

要排除规格文件名中包含"dialog"一词的所有规格，可以使用：

wdio wdio.conf.js --exclude dialog

提供--exclude选项时，它将覆盖配置或能力级别的exclude参数定义的任何模式。

运行套件和测试规格

运行整个套件以及各个规格。

wdio wdio.conf.js --suite login --spec ./test/specs/signup.js

运行多个特定的测试规格

在持续集成和其他情况下，有时需要指定多组规格来运行。WebdriverIO的wdio命令行工具接受通过管道传入的文件名（来自find，grep或其他）。

通过管道传入的文件名会覆盖配置的spec列表中指定的全局模式或文件名列表。

grep -r -l --include "*.js" "myText" | wdio wdio.conf.js

注意： 这_不会_覆盖用于运行单个规格的--spec标志。

使用MochaOpts运行特定测试

你还可以通过向wdio CLI传递特定于mocha的参数：--mochaOpts.grep来过滤你想要运行的特定suite|describe和/或it|test。

wdio wdio.conf.js --mochaOpts.grep myText
wdio wdio.conf.js --mochaOpts.grep "Text with spaces"

注意： Mocha将在WDIO测试运行器创建实例后过滤测试，因此你可能会看到几个实例被生成但实际上并未执行。

使用MochaOpts排除特定测试

你还可以通过向wdio CLI传递特定于mocha的参数：--mochaOpts.invert来过滤你想要排除的特定suite|describe和/或it|test。--mochaOpts.invert执行与--mochaOpts.grep相反的操作

wdio wdio.conf.js --mochaOpts.grep "string|regex" --mochaOpts.invert
wdio wdio.conf.js --spec ./test/specs/e2e/login.js --mochaOpts.grep "string|regex" --mochaOpts.invert

注意： Mocha将在WDIO测试运行器创建实例后过滤测试，因此你可能会看到几个实例被生成但实际上并未执行。

失败后停止测试

通过bail选项，你可以告诉WebdriverIO在任何测试失败后停止测试。

对于大型测试套件，当你已经知道你的构建会中断，但想避免完整测试运行的漫长等待时，这很有帮助。

bail选项需要一个数字，它指定在WebDriver停止整个测试运行之前可能发生多少测试失败。默认值为0，意味着它总是运行所有能找到的测试规格。

请参阅选项页面获取有关bail配置的更多信息。

运行选项层次结构

在声明要运行的规格时，有一定的层次结构定义哪种模式将优先。目前，这是它的工作方式，从最高优先级到最低：

CLI --spec参数 > capability specs模式 > config specs模式 CLI --exclude参数 > config exclude模式 > capability exclude模式

如果只给出配置参数，它将用于所有能力。然而，如果在能力级别定义模式，它将代替配置模式使用。最后，在命令行上定义的任何规格模式都将覆盖所有其他给定的模式。

使用能力定义的规格模式

当你在能力级别定义规格模式时，它将覆盖在配置级别定义的任何模式。当需要基于不同的设备能力分离测试时，这很有用。在这种情况下，在配置级别使用通用规格模式，在能力级别使用更具体的模式会更有用。

例如，假设你有两个目录，一个用于Android测试，另一个用于iOS测试。

你的配置文件可能会这样定义模式，用于非特定设备测试：

{
    specs: ['tests/general/**/*.js']
}

但随后，你将有不同的Android和iOS设备能力，其中模式可能如下所示：

{
  "platformName": "Android",
  "specs": [
    "tests/android/**/*.js"
  ]
}

{
  "platformName": "iOS",
  "specs": [
    "tests/ios/**/*.js"
  ]
}

如果你在配置文件中需要这两种能力，那么Android设备将只运行"android"命名空间下的测试，而iOS测试将只运行"ios"命名空间下的测试！

//wdio.conf.js
export const config = {
    "specs": [
        "tests/general/**/*.js"
    ],
    "capabilities": [
        {
            platformName: "Android",
            specs: ["tests/android/**/*.js"],
            //...
        },
        {
            platformName: "iOS",
            specs: ["tests/ios/**/*.js"],
            //...
        },
        {
            platformName: "Chrome",
            //config level specs will be used
        }
    ]
}