mirror of
https://github.com/RGBCube/serenity
synced 2025-10-31 10:12:45 +00:00
ea7b7d8ceb
These changes are arbitrarily divided into multiple commits to make it easier to find potentially introduced bugs with git bisect.
46 lines
1.3 KiB
Markdown
46 lines
1.3 KiB
Markdown
## Name
|
|
|
|
test-js - run the LibJS test suite
|
|
|
|
## Synopsis
|
|
|
|
```**sh
|
|
$ test-js [options...] [path]
|
|
```
|
|
|
|
## Description
|
|
|
|
`test-js` runs the LibJS test suite located in `/home/anon/js-tests`. These
|
|
tests are using a custom JavaScript testing framework inspired by
|
|
[Jest](https://jestjs.io) (see [`test-common.js`](/home/anon/js-tests/test-common.js)).
|
|
|
|
It also supports the [test262 parser tests](https://github.com/tc39/test262-parser-tests).
|
|
|
|
The test root directory is assumed to be `/home/anon/js-tests`, or `$SERENITY_ROOT/Libraries/LibJS/Tests`
|
|
when using the Lagom build. Optionally you can pass a custom path to `test-js` to override these defaults.
|
|
|
|
You can disable output from `dbgln()` calls by setting the `DISABLE_DBG_OUTPUT` environment variable.
|
|
|
|
## Options
|
|
|
|
* `-t`, `--show-time`: Show duration of each test
|
|
* `-g`, `--collect-often`: Collect garbage after every allocation
|
|
* `--test262-parser-tests`: Run test262 parser tests
|
|
|
|
## Examples
|
|
|
|
A very simple test looks like this:
|
|
|
|
```js
|
|
describe("Examples from Gary Bernhardt's 'Wat' talk", () => {
|
|
test("Na na na na na na na na na na na na na na na na Batman!", () => {
|
|
expect(Array(16).join("wat" - 1) + " Batman!").toBe(
|
|
"NaNNaNNaNNaNNaNNaNNaNNaNNaNNaNNaNNaNNaNNaNNaN Batman!"
|
|
);
|
|
});
|
|
});
|
|
```
|
|
|
|
## See also
|
|
|
|
* [`js`(1)](js.md)
|