Mercurial > people > rkennke > jdk9-shenandoah-final > nashorn
diff test/README @ 2:da1e581c933b
8005403: Open-source Nashorn
Reviewed-by: attila, hannesw, lagergren, sundar
Contributed-by: james.laskey@oracle.com, akhil.arora@oracle.com, andreas.woess@jku.at, attila.szegedi@oracle.com, hannes.wallnoefer@oracle.com, henry.jen@oracle.com, marcus.lagergren@oracle.com, pavel.semenov@oracle.com, pavel.stepanov@oracle.com, petr.hejl@oracle.com, petr.pisl@oracle.com, sundararajan.athijegannathan@oracle.com
author | jlaskey |
---|---|
date | Fri, 21 Dec 2012 16:36:24 -0400 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/test/README Fri Dec 21 16:36:24 2012 -0400 @@ -0,0 +1,78 @@ +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.