tees

tees is a complex of E2E test framework, it's based on jest as test runner.

Contents

• Getting Started
• Additional Configuration
• Tutorial
• Advanced Guides
• API Reference
  • Test CLI
  • Project Config
  • Test Drivers
  • Test Hooks
• Benchmark Results
• Contribution Guide

Getting Started

1. Initialize tees by cli:

npx tees init yourProjectName

2. Tees will ask you a few questions and will create a basic configuration file and an example file. Press Enter key to choose the default configuration.
3. Running from the command line, there is a folder "yourProjectName" under the current path:

cd yourProjectName

Run yarn install to install the necessary dependencies. It will take you several minutes.

yarn install

Run your E2E case:

npx tees run ./src/example.spec.js

Additional Configuration

Based on your project, there are several things need to config in e2e.config.js file. Add params in e2e.config.js, such as the project name, the type of your project.

module.exports  = {
  params: {
    projects: {
      //project name
      'example': {
        //uri or extension
        type: 'uri',
        //if your project is an extension, you need to add source path
        location: 'https://cn.bing.com/',
      }
    }
  },
  //...
};

Change the selectorLabel to what you are using, eg. class, id, or any other tag name.

module.exports  = {
  selectorLabel: 'class',
  //...
};

The default execution timeout for each test case is 2 minutes. If you want to change it to 20 minutes, you can add timeout in e2e.config.

module.exports  = {
  timeout: 1000  *  60  *  20,
  //...
};

Advanced Guides

CLI usage:

A simplest command can be: npx tees run yourTestFilePath

Use CLI params to control the test you are running:

params

Run all cases which met all these params.

-P '{brands:["rc"],levels:["p0","p1"],tags:[["widgets"]]}'

drivers

Run case on specific driver

-D puppeteer

or use ',' to split difference drivers

-D puppeteer,chrome

supported drivers:

1. puppeteer
2. chrome
3. firefox
4. edge
5. ie
6. safari
7. enyzme

sandbox

With sandbox mode, every case will start a totally new driver. Without sandbox mode, every run will only start a driver.

debugger

With debugger mode, some additional debug message will output. Default OFF.

headless

Headless default OFF.

exclude

Use exclude to ignore some unnecessary path.

-E ./node_modules/

to ignore more than one path

-E ./node_modules/ ./__temp__/

verbose

Enable verbose to get more imformation when debugging.

retry

Rerun case when there are some error occur. The default value of retry time is 0. The maximum retry times is 10.

-T 3

reporter

Enable reporter will push your console output to an on-line web.

testerCLI

Jest CLI. Pass params to jest via this testerCLI.

-C '--findRelatedTests path/to/fileA.js path/to/fileB.js'

Note: And you can append all these commands together.

The command below will run test file 1 and 2 in puppeteer on sandbox and headless mode. Example:

npx tees run yourTestFilePath1 yourTestFilePath2 -D puppeteer -S -H

E2E config

APIs Reference

Test CLI

Project Config

Test Drivers

Driver APIs

Query APIs

Test Hooks

example:

context.driver.addAfterHook(async () => {
  await process.exec(Logout);
});

Benchmark Results

// device and environmental information

Chrome is selenium webdriver's Chrome.
Selenium webdriver multithreading operation is not stable.
Selenium Webdriver Safari does not support multithreading.
Enzyme does not support non-sandbox mode(Default forced sandbox mode).

Contribution Guide

Read our contribution guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Tees.

License

Tees is MIT licensed.