view nashorn/test/README @ 43374:d312a15c5fcf

8081820: javadoc does not report warnings in case of multiple "@param" tags for the same parameter and multiple "@return" tags for the same method. Reviewed-by: jjg Contributed-by: istomin.den@gmail.com
author jjg
date Fri, 27 Jan 2017 15:49:14 -0800
parents
children
line wrap: on
line source
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.