tape. Start testing your code locally in seconds and seamlessly move to cloud based browsers powered by Sauce Labs for better coverage.
Airtap is different than other cross browser test runners in its simplicity and ability to easily run your test suite in many browsers without having them installed locally. It lets you iterate quickly during development and provide good browser coverage before release without worrying about missing a supported browser.
This project is a fork of the amazing Zuul. Please note that our API is currently unstable and some documentation may be out of date. Anyone is welcome and encouraged to contribute towards 1.0.0 via a pull request.
With npm do:
npm install airtap --save-dev
If you are upgrading or migrating from zuul: please see the upgrade guide.
Airtap works out of the box with
tape. If you're already using these, setup will be trivial.
Airtap has 3 modes of operation: locally, cloud browsers, and continuous integration. You should make sure that airtap is working locally before you try to run the other two.
Airtap will do all the hard work of setting up your test harness, support files, and cloud browser integration so you can just focus on writing your tests.
All you need is an entry point for your tests like
test.js. When iterating on your tests during development, simply use
--local mode to see your tests run in a browser.
See the included example for a simple test. Run it by issuing the following command in the example directory:
airtap --local 8080 test.js
It will print a URL that you can open in any local browser to run the tests. Make changes to the code as needed. No need to restart airtap, just refresh your browser.
Cross browser testing via Sauce Labs
The reason we go through all this trouble in the first place is to seamlessly run our tests against all those browsers we don't have installed. Luckily, Sauce Labs runs quite a few browsers and we can easily task airtap to test on those.
Airtap itself is also tested in Sauce Labs.
No testing setup would be complete without a badge for passing or failing tests. After making sure your tests all pass in the cloud from your local machine, we will configure our tests to pass from Travis when we commit changes. See the Travis CI guide.
Who Uses Airtap?
Lots of folks! Collectively, packages that depend on Airtap get 10's of millions of downloads per month!
- Send a PR to add your package to the list!
Airtap is an OPEN Open Source Project. This means that:
Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.
See the contribution guide for more details.
Airtap consumes a YAML config file. See the airtap.yml guide for all of the goodies this file provides.
It includes advanced usage like how to run an additional server to support tests that make ajax requests.
Cross-browser Testing Platform and Open Source ♥ Provided by Sauce Labs.