## Synopsis
`ceylon test-js [--cacherep=<url>] [--compile[=<flags>]] [--cwd=<dir>] [--debug=<debug>] [--define=<key>=<value>...] [--maven-overrides=<url>] [--no-default-repositories] [--node-exe=<node-exe>] [--offline] [--rep=<url>...] [--report] [--sysrep=<url>] [--tap] [--test=<test>...] [--timeout=<seconds>] [--verbose[=<flags>]] [--version=<version>] [--] <modules...>`

## Description
Executes tests in specified `<modules>`. The `<modules>` arguments are the names of the modules to test with an optional version.

## Options
`--cacherep=url` | Specifies the folder to use for caching downloaded modules. (default: `~/.ceylon/cache`)
`--compile[=flags]` | Determines if and how compilation should be handled. Allowed flags include: `never`, `once`, `force`, `check`.
`--cwd=dir` | Specifies the current working directory for this tool. (default: the directory where the tool is run from)
`--debug=debug` | Shows more detailed output in case of errors.
`--define=key>=<value`, `-D key>=<value` | Set a system property
`--maven-overrides=url` | Specifies the xml file to use to load Maven artifact overrides.
`--no-default-repositories` | Indicates that the default repositories should not be used.
`--node-exe=node-exe` | The path to the node.js executable. Will be searched in standard locations if not specified.
`--offline`, `-L` | Enables offline mode that will prevent connections to remote repositories.
`--rep=url` | Specifies a module repository containing dependencies. Can be specified multiple times. (default: `modules`, `~/.ceylon/repo`, `http://modules.ceylon-lang.org/repo/1`)
`--report` | Generates the test results report into HTML format, output directory is `reports/test-js` (experimental).
`--sysrep=url` | Specifies the system repository containing essential modules. (default: `$CEYLON_HOME/repo`)
`--tap` | Enables the Test Anything Protocol v13.
`--test=test` | Specifies which tests will be run.
`--timeout=seconds`, `-T seconds` | Sets the timeout for connections to remote repositories, use 0 for no timeout (default: 20).
`--verbose[=flags]`, `-d` | Produce verbose output. If no `flags` are given then be verbose about everything, otherwise just be verbose about the flags which are present. Allowed flags include: `all`, `loader`.
`--version=version` | Specifies which version of the test module to use, defaults to 1.1.0.

## Configuration file
The test-js tool accepts the following option from the Ceylon configuration file: `testtool.compile` (the equivalent option on the command line always has precedence).## EXAMPLE The following would execute tests in the `com.example.foobar` module:
    ceylon test-js com.example.foobar/1.0.0