Runs front-end mocha tests using puppeteer
Last updated a year ago by paulvarache .
MIT · Original npm · Tarball · package.json
$ cnpm install @kano/web-tester 
SYNC missed versions from official npm registry.

Web Tester

Runs front-end mocha tests using puppeteer


The web tester should always be installed as a local dependency, and the binary using npm scripts.

This ensures that the required tools are a dependency of your project

Install with:

yarn add --dev @kano/web-tester


Place your test files in a directory e.g. test. web-tester wil look for all .js files in a given directory.

Run your tests with either:

# run tests with puppeteer and print the results to the console
web-tester run **/*test.js

# Serve a web page that runs the tests
web-tester serve **/*test.js

# Generate a coverage report
web-tester cover **/*test.js

You can create a .web-tester.conf.json to configure both mocha and puppeteer:

    "mocha": {
        "ui": "tdd"
    "puppeteer": {
        "slowMo": 1000

In your package.json add a test script as follow to automate your tests

    "scripts": {
        "test-ci": "web-tester run ./test -r xunit > test-results.xml"


Command Options
serve --port: Specifiy which port to use. Default: 8000
run --no-headless: Run puppeteer in no-headless mode. Displays the browser. Default: false
--reporter, -r: Sepecify which reporter to use, spec or xunit. Default: spec
cover --no-headless: Run puppeteer in no-headless mode. Displays the browser. Default: false
--reporter, -r: Specify which reporter to use. All istanbul reporters are available. An additional markdown reporter is available to generate a markdown summary table. You can add multiple reports. Default: text-summary


The default assertion library is assert from chai. You can access it with:

import { assert } from '@kano/web-tester/helpers.js';

assert.equal(2, 2);

The fixture helper allows you to prepare HTML Templates, access their elements directly and takes care of adding/removing them from the DOM automatically:

import { fixture } from '@kano/web-tester/helpers.js';

const basic = fixture`

suite('my-el', () => {
    test('constructor', () => {
        // Returns the first element in the fixture.
        // These will be removed at the end of the test
        const el1 = basic();
        const el2 = basic();

Current Tags

  • 1.0.0-alpha.20                                ...           latest (a year ago)

20 Versions

  • 1.0.0-alpha.20                                ...           a year ago
  • 1.0.0-alpha.19                                ...           a year ago
  • 1.0.0-alpha.18                                ...           a year ago
  • 1.0.0-alpha.17                                ...           a year ago
  • 1.0.0-alpha.16                                ...           a year ago
  • 1.0.0-alpha.15                                ...           a year ago
  • 1.0.0-alpha.13                                ...           a year ago
  • 1.0.0-alpha.14                                ...           a year ago
  • 1.0.0-alpha.12                                ...           a year ago
  • 1.0.0-alpha.11                                ...           a year ago
  • 1.0.0-alpha.10                                ...           a year ago
  • 1.0.0-alpha-9                                ...           a year ago
  • 1.0.0-alpha.8                                ...           a year ago
  • 1.0.0-alpha.7                                ...           a year ago
  • 1.0.0-alpha.6                                ...           2 years ago
  • 1.0.0-alpha.5                                ...           2 years ago
  • 1.0.0-alpha.4                                ...           2 years ago
  • 1.0.0-alpha.3                                ...           2 years ago
  • 1.0.0-alpha.2                                ...           2 years ago
  • 1.0.0-alpha.1                                ...           2 years ago
Today 0
This Week 20
This Month 22
Last Day 20
Last Week 0
Last Month 1
Dependencies (19)
Dev Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |