Skip to content
Fast and Reliable E2E Web Testing with only Javascript
JavaScript CSS HTML Shell
Branch: master
Clone or download
BenAHammond Merge pull request #15 from Nike-Inc/traceFlag
Adds resource request tracing to the Localproxy to the `--verbose` CLI parameter
Latest commit 0dfde38 Dec 22, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
packages removing unnecessary false, adding eslint rule target Dec 18, 2017
.editorconfig initial move Sep 28, 2017
.eslintrc initial move Sep 28, 2017
.gitattributes initial move Sep 28, 2017
.gitignore Oct 16, 2017
.npmignore initial move Sep 28, 2017
LICENSE code merge Nov 6, 2017 Fix the tutorial script for Windows users Nov 10, 2017 initial move Sep 28, 2017 initial move Sep 28, 2017
lerna.json initial move Sep 28, 2017
overview.png initial move Sep 28, 2017
package.json Fix the tutorial script for Windows users Nov 10, 2017
publish.js initial move Sep 28, 2017 adding shorthand to the cli docs, adding verbose to the cli docs Dec 18, 2017


Test your entire app, end to end, in pure JavaScript

Burnside is an easy to use, modular, and extendable End to End (E2E) testing tool. Burnside leverages the flexibility of JavaScript and the power of modern Browser APIs to inject logic and scripting into your website, without the slowdown of networking for every individual command.

Looking for something more hands on? Check out Burnside's interactive, Test-Driven Tutorial!


$ npm install --save-dev burnside-cli


  "scripts": {
    "burnside": "burnside ./path/to/tests.js --startup='./' --condition='start' --wait=5000 --browsers=chrome,firefox"

Command Line Options

Burnside's CLI supports the following flags:

.alias('b', 'browsers') .alias('t', 'timeout') .alias('s', 'startup') .alias('c', 'condition') .alias('k', 'karmaConfig') .alias('v', 'verbose')

Options Example Purpose
<default> ./path/to/tests.js Your Test File. Webpack is built in so use require for more files.
--verbose -v --verbose Turns up logging and adds request tracing
--startup -s --startup='./' An optional startup command for your application.
--condition -c --condition='startup' An optional startup message for Burnside to wait on
--wait -w --wait=500 The amount of time Burnside will wait for the startup condition to be reached, if specified. Defaults to 5000
--browsers -b --browsers=chrome,firefox The browsers Burnside should attempt to use when testing. You're responsible for making sure they are installed and configured. Available: chrome and firefox
--karmaConfig -k --karmaConfig=./burnside.karma.conf.js A relative path to an optional Karma configuration. You can use this to override settings, inject Karma plugins, and configure them while also allowing Burnside to add in its own required Karma configuration to be layered on afterward. For more information visit on how to work with Karma, visit its Documentation

Burnside is a modular ecosystem based on a core that runs inside of a Browser. The CLI bundles Karma and Webpack to load your tests within Chrome, but you can use Burnside's core with any Test Runner you'd like to set up.

If you'd like to configure your own test runner, we've included a Sample project configured to use Karma and Webpack directly.

Test usage

const Burnside = window.Burnside; // or `import Burnside` if you're not using the CLI

const burnside = new Burnside({
  host: 'http://localhost:3000',
  path: '/index.html'

// now you can execute any function and capture the result!
  .exec(['.header'], selector => {
    return document.querySelector(selector);
  .then(value => {
    // assert on value here

For more complete documentation of Burnside, check out our API and Architecture documentation.

Burnside Local Proxy Configuration

Burnside consists of two main moving parts: the Core JS and a Proxy that runs locally in the background that handles injecting Burnside's JS Client into the page. Because the proxy is used by the browsers for every outbound request, we've also added some additional features that can allow you to fine tune your testing.

Burnside's proxy is configured via a .burnside-localproxyrc at the root of your project. Below is a documented example:

  "key": "./certs/localhost.privkey.pem", // the key and certificate to use for SSL decryption
  "cert": "./certs/localhost.cert.pem",
  "port": 9888, // the port you want the Proxy to run on
  "extensions": [  // an array of names of Extensions for Burnside to use when injecting the client
  "replaceImages": true,  // enables a feature that replaces all images with a default for faster testing (also accepts an image filepath e.g. "./path/to/my/image.png" )
  "injects": [ // an array of urls mapped into injected javascript tags
  "request": { // headers to (over)write on outbound network requests
    "headers": {
      "secret-custom-header": "<SHARED-SECRET>"
  "response": { // headers to (over)write on network request responses
    "headers": {
      "Access-Control-Allow-Origin": "*"

Note: In order to intercept and decrypt SSL traffic Burnside's Local Proxy utilizes a simple self signed certificate. If you encounter issues decrypting SSL pages, consider regenerating these files with fresh credentials using the script found in /packages/burnside-localproxy/ as a base.

How It Works

Burnside runs your application inside an iframe and uses iframe messaging to communicate between test code and the application. This is in contrast to the approach taken by the Selenium webdriver, which instead uses HTTP to communicate interactions between tests and the application, introducing more network latency and inconsistency to your test suite.


Tutorial Setup Instructions

The Burnside tutorial is a set of exercises designed to walk you through how to use Burnside properly and to give you some pointers in the process. To run it, you need to clone the repository and install its dependencies.

System requirements: Node Runtime Installed Matching the package.json specifications

git clone

cd burnside && npm run tutorial

Now you're all configured! If you'd like to contribute to the Tutorial, please read our Tutorial Developers Guide



You can’t perform that action at this time.