Running the Tests

Follow Google V8 checkout and build instructions.

Set the V8_HOME environment variable to the path where d8 was built, for example:

export V8_HOME="$HOME/v8/out/x64.release"

Verify via:

echo quit | $V8_HOME/d8

Get the JavaScript shell (jsshell) from https://ftp.mozilla.org/pub/mozilla.org/firefox/nightly/latest-mozilla-central/. Set your SPIDERMONKEY_HOME environment variable to installation location.

Verify via:

$SPIDERMONKEY_HOME/js --version

On macOS we test with JavaScriptCore. JavaScriptCore (jsc) should be on your system, but needs to be added to your PATH environment variable so that it will be found, for example:

export PATH="$PATH:/System/Library/Frameworks/JavaScriptCore.framework/Versions/A/Resources"

Verify that jsc brings up a prompt.

Setup the $NASHORN_HOME environment variable so that

$NASHORN_HOME/jjs

prompts a JavaScript Console. Nashorn is usually under $JAVA_HOME/bin, so you can write:

export NASHORN_HOME="$JAVA_HOME/bin"

Verify via:

echo 'quit()' | $NASHORN_HOME/jjs -fv

Get GraalVM from https://www.graalvm.org. Set your GRAALVM_HOME environment variable so that $GRAALVM_HOME/js executes Graal.js.

Verify via:

$GRAALVM_HOME/js --version

Get ChakraCore from https://github.com/Microsoft/ChakraCore/releases. Set your CHAKRACORE_HOME environment variable so that $CHAKRACORE_HOME/ch executes ChakraCore.

Verify via:

$CHAKRACORE_HOME/ch -version

Will run tests for each JavaScript runtime that you setup as described above, runtimes that you did not setup will be skipped.

If you have Node.js installed, you can run the bootstrapped ClojureScript test suite (located at src/test/self/self_host/test.cljs):

You can also build and run the ClojureScript compiler test suite in bootstrapped mode within Node.js by running

You can run tests exercising the ClojureScript CLI by running

where repl-env is any of the built-in REPL environments (node, browser, etc.). This will be passed to cljs.main 's -re option.

Note that testing with graaljs REPL environment requires GRAALVM_HOME to be found early in your PATH. You can test via:

You can also specify a non-built-in REPL environment, but you would have to revise script/test-cli to include the downstream REPL environment on the classpath. You can also pass optional repl-env-opts-edn, which will be passed to cljs.main 's -ro option.

It is important to make sure that the Browser REPL hasn’t accidentally been broken.

You may have already run tests against the browser REPL via ./script/test-cli browser. If not, now is a good time to do so. Note: It is normal for this test to launch plenty of browser windows/tabs.

In addition, you might only be comfortable after some manual verification - if only to try a sanity (js/alert "Hello CLJS!"):