puppeteer/utils/testrunner
2018-09-21 17:27:10 -07:00
..
examples chore: testrunner's ".not" should print appropriate message (#2459) 2018-04-26 11:13:22 -07:00
.npmignore chore: add .npmignore for testrunner (#3290) 2018-09-21 17:27:10 -07:00
index.js tests: drop jasmine test runner (#1519) 2017-12-07 16:37:22 -08:00
LICENSE chore: prepare testrunner to be published to npm (#3289) 2018-09-21 14:51:22 -07:00
Matchers.js feat: introduce puppeteer/Errors (#3056) 2018-08-09 16:51:12 -07:00
Multimap.js tests: drop jasmine test runner (#1519) 2017-12-07 16:37:22 -08:00
package.json chore(testrunner): bump version to v0.5.0-post (#3291) 2018-09-21 15:25:17 -07:00
README.md chore: prepare testrunner to be published to npm (#3289) 2018-09-21 14:51:22 -07:00
Reporter.js chore: nicer stack highlight (#3259) 2018-09-17 23:22:53 +01:00
TestRunner.js test: dump workers state after the test runner is terminated (#2991) 2018-07-30 18:57:48 -07:00

Puppeteer TestRunner

  • testrunner is a library: tests are node.js scripts
  • parallel wrt IO operations
  • supports async/await
  • modular
  • well-isolated state per execution thread

Installation

npm install --save-dev @pptr/testrunner

Example

Save the following as test.js and run using node:

node test.js
const {TestRunner, Reporter, Matchers} = require('@pptr/testrunner');

// Runner holds and runs all the tests
const runner = new TestRunner({
  parallel: 2, // run 2 parallel threads
  timeout: 1000, // setup timeout of 1 second per test
});
// Simple expect-like matchers
const {expect} = new Matchers();

// Extract jasmine-like DSL into the global namespace
const {describe, xdescribe, fdescribe} = runner;
const {it, fit, xit} = runner;
const {beforeAll, beforeEach, afterAll, afterEach} = runner;

// Test hooks can be async.
beforeAll(async state => {
  state.parallelIndex; // either 0 or 1 in this example, depending on the executing thread
  state.foo = 'bar'; // set state for every test
});

describe('math', () => {
  it('to be sane', async (state, test) => {
    state.parallelIndex; // Very first test will always be ran by the 0's thread
    state.foo; // this will be 'bar'
    expect(2 + 2).toBe(4);
  });
});

// Reporter subscribes to TestRunner events and displays information in terminal
const reporter = new Reporter(runner);

// Run all tests.
runner.run();