Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

airtap

Package Overview
Dependencies
Maintainers
3
Versions
25
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

airtap

JavaScript browser testing in the cloud

  • 3.0.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
3.1K
increased by38.62%
Maintainers
3
Weekly downloads
 
Created
Source

airtap

Test your JavaScript in 800+ browsers.

npm status node Build Status Dependency status

Airtap is an easy way to test your JavaScript in browsers, using a TAP-producing harness like tap or 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.

Don't just claim your JavaScript supports "all browsers", prove it with tests!

This project is a fork of the amazing Zuul. Please note that some documentation may be out of date. Anyone is welcome and encouraged to contribute via a pull request.

Install

With npm do:

npm install airtap --save-dev

If you are upgrading or migrating from Zuul: please see the upgrade guide.

Workflow

Airtap works out of the box with tap and 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.

Running locally

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 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.

local screenshot

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.

See the Cloud Testing guide to get your tests running in the cloud. TLDR: save your credentials to ~/.airtaprc, add browsers to .airtap.yml and issue:

airtap test.js

sauce labs screenshot

Continuous Integration

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.

Sauce Test Status

Who Uses Airtap?

Lots of folks! Collectively, packages that depend on Airtap get 100's of millions of downloads per month!

Contributing

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.

Configuration

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.

Big Thanks

Cross-browser Testing Platform and Open Source ♥ Provided by Sauce Labs.

Sauce Labs logo

License

MIT © Roman Shtylman, Zuul contributors and Airtap contributors.

Keywords

FAQs

Package last updated on 17 Jan 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc