Zuul is an easy way to test your javascript in browsers. Start testing your code in seconds locally and move to cloud based browsers seamlessly for better coverage.
Zuul 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 js supports "all browsers", prove it with tests!
Zuul works out of the box with a few commonly used javascript frameworks (qunit, mocha, tape, jasmine). If you are already testing using these, zuul setup will be trivial.
Zuul has 3 modes of operation: locally, cloud browsers, and continuous integration. You should make sure that zuul is working locally before you try to run the other two.
Once you have installed zuul proceed to the quickstart to write your first test.
When iterating on your tests during development, simply use zuul --local mode to see your tests run in a browser.
See the quickstart page on the wiki for more details.
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, saucelabs runs some browsers and we can easily task zuul to test on those.
See the cooking with sauce wiki page to get your tests running in the cloud.
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-ci when we commit changes.
See the travis-ci integration wiki page.
The following frameworks are supported:
See the examples directory for some simple tests. Use the above knowledge to test the examples with your install of zuul.
All of the examples can be tested locally by running the following command in each example directory.
zuul --local 8080 -- test.js
The zuul consumes a yaml config file. See the zuul.yml wiki page 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.
MIT
This project is made possible by all the awesome modules it uses. See the package.json file for all the awesome.
3.6.0 (2015-09-20)
browser_open_timeout configuration, default to 120s (same as before)
FAQs
simple browser testing
The npm package zuul receives a total of 3,246 weekly downloads. As such, zuul popularity was classified as popular.
We found that zuul demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
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.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.