Nashorn tests are TestNG based. Running tests requires downloading the TestNG

library and placing its jar file into the lib subdirectory:

   # download and install TestNG

   wget http://testng.org/testng-x.y.z.zip

   unzip testng-x.y.z.zip

   cp testng-x.y.z/testng-x.y.z.jar lib/testng.jar

   # run tests

   cd ..

   ant test

This will fail with a message like

    taskdef class org.testng.TestNGAntTask cannot be found

if the TestNG jar file is not installed properly or if the wrong

version is present. (Check build.xml to find the version of TestNG

that is required.)  Only the jar file is necessary. The unzipped

hierarchy can be removed.

We have tested using TestNG 6.7 as well ad TestNG 6.8. TestNG 6.7's jar file

is also available as part of jtreg 4.1 b05 which can be downloaded at

http://download.java.net/openjdk/jtreg/

ECMAScript script test framework:

* Test tags for test framework:

The test runner crawls these directories for .js files and looks for JTReg-style

@foo comments to identify tests.

    * @test - A test is tagged with @test.

    * @test/fail - Tests that are supposed to fail (compiling, see @run/fail

      for runtime) are tagged with @test/fail.

    * @test/compile-error - Test expects compilation to fail, compares

      output.

    * @test/warning - Test expects compiler warnings, compares output.

    * @test/nocompare - Test expects to compile [and/or run?]

      successfully(may be warnings), does not compare output.

    * @subtest - denotes necessary file for a main test file; itself is not

      a test.

    * @run - A test that should be run is also tagged with @run (otherwise

      the test runner only compiles the test).

    * @runif - A test that should be run only if a specific System property

      is defined (Example: @runif external.v8)

    * @run/fail - A test that should compile but fail with a runtime error.

    * @run/param - specify runtime arguments to script.

    * @run/ignore-std-error - script may produce output on stderr, ignore

      this output.

    * @compilearg \ - pass arg to compiler, sample.

/**

 * @compilearg --dump-ir-graph

 * @test/warning

 */

    * @compilefirst foo.js - foo.js being a necessary file for a test; it

      may or may not itself be a test. These are compiled separately before

      main test file.

    * @compile/fail foo.js - foo.js being a necessary file for a test; it

      may or may not itself be a test, compile should fail. These are compile

      with main file.

    * @compile bar.js - bar.js being a necessary file for a test; it may or

      may not itself be a test. These are compiled with main file.