Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/defunctzombie/zuul
[UNMAINTAINED] multi-framework javascript browser testing
https://github.com/defunctzombie/zuul
Last synced: 4 months ago
JSON representation
[UNMAINTAINED] multi-framework javascript browser testing
- Host: GitHub
- URL: https://github.com/defunctzombie/zuul
- Owner: defunctzombie
- Archived: true
- Created: 2012-12-23T20:27:51.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2021-08-10T22:47:22.000Z (over 3 years ago)
- Last Synced: 2024-05-17T05:43:53.592Z (9 months ago)
- Language: JavaScript
- Homepage:
- Size: 1.59 MB
- Stars: 958
- Watchers: 22
- Forks: 86
- Open Issues: 55
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
Awesome Lists containing this project
- awesome-github-repos - defunctzombie/zuul - [UNMAINTAINED] multi-framework javascript browser testing (JavaScript)
README
**/!\ This software is not maintained and was not updated for several years, if you want to do browser testing we recommend you use different tools. Which ones? I have no idea but if you do, please open a PR so we can list them here /!\**
# [DEPRECATED] zuul [](https://travis-ci.org/defunctzombie/zuul)
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!
If you are looking for the edge routing service named Zuul that is related to Netflix, it can be found here:
https://github.com/Netflix/zuul
If you are looking for the OpenStack related test automation tool that is also named Zuul, you can find it here:
https://docs.openstack.org/infra/zuul/feature/zuulv3/
## Zuul workflow
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](https://github.com/defunctzombie/zuul/wiki/installation) zuul proceed to the [quickstart](https://github.com/defunctzombie/zuul/wiki/quickstart) to write your first test.
### Running zuul locally
When iterating on your tests during development, simply use zuul `--local` mode to see your tests run in a browser.
See the [quickstart](https://github.com/defunctzombie/zuul/wiki/quickstart) page on the wiki for more details.
### Cross browser testing via Saucelabs
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](https://saucelabs.com/) runs some browsers and we can easily task zuul to test on those.
See the [cooking with sauce](https://github.com/defunctzombie/zuul/wiki/cloud-testing) wiki page to get your tests running in the cloud.
### 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-ci when we commit changes.
See the [travis-ci integration](https://github.com/defunctzombie/zuul/wiki/travis-ci) wiki page.
## Frameworks
The following frameworks are supported:
* mocha (tdd, qunit, and bdd flavors)
* tape
* qunit
* jasmine
### Examples
See the examples directory for some simple tests. Use the above knowledge to test the examples with your install of zuul.
* [quickstart](https://github.com/defunctzombie/zuul/tree/master/examples/quickstart) - from the [quickstart](https://github.com/defunctzombie/zuul/wiki/Quickstart) wiki tutorial
* [emberjs with qunit](https://github.com/defunctzombie/zuul/tree/master/examples/ember_w_qunit) - basic ember.js app with qunit tests
* [jasmine](https://github.com/defunctzombie/zuul/tree/master/examples/jasmine) - basic jasmine example
All of the examples can be tested locally by running the following command in each example directory.
```
zuul --local 8080 -- test.js
```
## zuul.yml
The zuul consumes a yaml config file. See the [zuul.yml](https://github.com/defunctzombie/zuul/wiki/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.
## License
MIT
## Credits
This project is made possible by all the awesome modules it uses. See the `package.json` file for all the awesome.