Repository files navigation

TestSwarm provides distributed continuous integration testing for JavaScript.

⚠️ Project statusTestSwarm remains used by jQuery Foundation projects such as jQuery and jQuery UI, but is no longer under active development. Critical issues may be patched, but new issues will not be addressed.

We recommend reviewing these alternatives:QTap,Karma,Testem,grunt-contrib-qunit,browserstack-runner,Airtap,Intern,Web Test Runner.

• About TestSwarm (Philosophy, Architecture, How is it different?)
• API Guide
• Automation Guide
• How to: Submit jobs
• Project history (Screenshots)

Further reading:

• JavaScript Testing Does Not Scale, John Resig, 2009.
• TestSwarm Alpha Open!, John Resig, 2009.
• JSConf talk: TestSwarm, John Resig, 2009.
• Video: TestSwarm Walkthrough, John Resig, 2009.

Clone the repo

git clone https://github.com/jquery/testswarm.git

• Chrome 58+ (2017)
• Edge 15+ (2017, both legacy MSEdge and Chromium-based)
• Firefox 45+ (2016)
• Internet Explorer 9+
• Opera 36+ (2016)
• Safari 9+ (2015)
• Android 4.3+ (2013)
• iOS Mobile Safari 7+ (2013)

To run TestSwarm you will need a web server, a database server and PHP.At the moment TestSwarm supports the following, but other configurationsmay work as well.

• Apache 2.0+, NGINX 1.10+
• PHP 5.4+ (or PHP-FPM for NGINX)
• MySQL 5.6+
• cURL (for the cleanup action; see step 8)

1. Create an empty MySQL database and create a user with read and write access to it.

2. Copyconfig/sample-localSettings.php toconfig/localSettings.php
   Copyconfig/sample-localSettings.json toconfig/localSettings.json.
   EditlocalSettings.json and replace the sample settings with your own.
   Refer to theSettings page for more information.

3. For Apache:
   Copyconfig/sample-.htaccess to.htaccess.
   To run TestSwarm from a non-root directory, setweb.contextpath inlocalSettings.json to thecorrect path from the web root and update RewriteBase in.htaccess.Verify that.htaccess is working properly by opening a page other than the HomePage (e.g./testswarm/projects) in your browser.
   Required Apache configuration:
   

   • AllowOverride is set toAll (or ensureFileInfo is included).
   • mod_rewrite installed and loaded.

   For NGINX:
   Copyconfig/sample-nginx.conf to/etc/nginx/sites-available.
   The file name should match your domain e.g. for swarm.example.org:
   cp config/sample-nginx.conf /etc/nginx/sites-available/swarm.example.org.conf
   Open this conf file in your editor and replace the "example" values with the correct values.
   Make sure your install is located at/var/www/testswarm(otherwise update the file to match the correct location).
   Now you need to link thesites-available config to thesites-enabled config:
   (replace the "swarm.example.org" with your own file name):
   ln -s /etc/nginx/sites-available/swarm.example.org.conf /etc/nginx/sites-enabled/swarm.example.org.conf
   Now make sure that php-fpm is running:/etc/init.d/php-fpm status
   if is not running start it:/etc/init.d/php-fpm start

4. Copyconfig/sample-robots.txt torobots.txt
   Or, if TestSwarm is not in the root directory, add similar rules to your rootrobots.txt.

5. Setstorage.cacheDir to a writable directory that is not readable from theweb. Either set it to a custom path outside the document root, or use thedefaultcache directory (protected with .htaccess).
   Chmod it:chmod 777 cache.

6. Install dependenciescomposer install --no-dev

7. Install the TestSwarm database by running:php scripts/install.php

8. Create an entry in your crontab for action=cleanup. This performs variouscleaning duties such as making timed-out runs available again.
   * * * * * curl -s https://swarm.example.org/api.php?action=cleanup > /dev/null

9. Create a project andsubmit jobs.

You're welcome to use the GitHubissue trackerto start discussions.

Some of us are also on Gitter atjquery/dev.

SeeLICENSE.txt.

TestSwarm uses the Semantic Versioning guidelines as much as possible.

Releases will be numbered in the following format:

<major>.<minor>.<patch>

The-alpha suffix is used to indicate unreleased versions in development.

For more information on SemVer, please visithttps://semver.org/.