Unit Testing

Learn how to write unit tests for Firebug code base.

Running Firebug Test Suite

The first thing you want to usually do before implementing a new test is setup your test environment and run the existing test suite to make sure all is up and running.

1. git clone https://github.com/firebug/firebug.next.git
2. Make sure you have an updated copy of Firefox Nightly installed.
3. Make sure you have npm & jpm installed. Read instructions.
4. Install Firebug's dependencies by running npm install in the source directory (created in step 1).
5. Run tests using jpm test -b nightly -v in the source directory.

Travis

Firebug repository is integrated with Travis. You can see the build status here.

Addon-httpd

Firebug uses addon-httpd module (see devDependency in package.json) as HTTP server for tests (see MDN).

Tips & Tricks

• In order to run only specific tests use --filter=FILENAME[:TESTNAME]. This only run tests whose filenames match FILENAME and optionally match TESTNAME, both regexps. For example: if you specify --filter data, then jpm will only run tests in those modules whose name contain the string "data".

Test API

TODO