For development and bug fixing the tests have to run in a Web browser. 

For this an openBIS instance has to start up. To get such a test instance running with all core-plugins with 
the test suits the build file 'build.gradle' has to be temporarily modified (do not check in this change!): 
Replace line 

options.suites('source/java/tests.xml') 

by

options.suites('source/java/tests-dev.xml') 

Then start up everything by executing inside the gradle/ directory:

./gradlew js-test:clean js-test:test

This will start up openBIS AS and two DSSs. 

When the console output is no longer busy Firefox should be started.
Enter the following URL: http://localhost:20000/openbis/
You should be able to log in as user 'admin' with any password.

Next choose a test suite in menu 'Utilities'. A tab will be opened which shows all tests.

If a test fails you can click on the test and only the failed test will be shown.

You can change the test code (e.g. in servers/common/core-plugins/tests/1/as/webapps/openbis-test/html/openbis-test.js).
To see the changes you have to reload the frame (not the application) in the Web browser.

Some Tips:
==========

Developing:
-----------

Change the code not in the original Javascript file but also in the file in targets/gradle/webapps/webapp. 
Otherwise the old code is executed. This isn't necessary for testing classes.

Debugging:
----------

Out comment the line

require.urlArgs = 'now=' + Date.now();

in servers/common/core-plugins/tests/1/as/webapps/openbis-v3-api-test/html/index.html if you want to debug
Javascript in the browser. Don't forget to bring the statement back before you do development again.

==== The instructions below are probably out dated after the move from ANT to gradle

To run js tests manually:
- run create-webapp-common and run-webapp-common ant targets and wait until AS, DSS1 and DSS2 start up
- login as admin to openBIS at http://localhost:20000/openbis/ using Firefox browser
- enter Utilities->openbis-test.js and Utilities->openbis-screening-test.js to run js tests

To run automatic js tests on a new server:
- run create-webapp-common and run-automated-tests-on-new-server ant targets

To run automatic js tests on an existing and already running server:
- run create-webapp-common and run-automated-tests-on-existing-server ant targets

To run a lab specific webapp:
- download database dumps from lascar:/links/groups/cisd/js-test/XXX directory to
  appropriate local directories i.e. pathinfo_test_js_XXX.js to servers/XXX/datastore_server/db
  and openbis_test_js_XXX.js to servers/XXX/openBIS-server/db
- download and extract a store dump from lascar:/links/groups/cisd/js-test/XXX directory to
  local directory servers/XXX/datastore_server/data/store
- run create-webapp-XXX and run-webapp-XXX ant targets
- openBIS is running at http://localhost:20000/openbis/