f863ba5554
AVA stores snapshots in a binary format (`.snap`), which produces no meaningful diffs and bloats Git history. This replaces AVA with the built-in `node:test` module, whose snapshot support generates human-readable text files that are easy to diff and review in pull requests. The migration also replaces `@sinonjs/fake-timers` and `execa` with Node.js built-ins (`node:test` mock timers and `node:child_process`), removing three dev dependencies total. ### Changes - **`tests/index.js`**: Rewritten to use `node:test` with a custom snapshot serializer that renders strings with actual newlines. Uses subtests for labeled `stderr`/`stdout` snapshots, and only snapshots non-empty output. - **`tests/main-repo-skew.test.js`**: Replace `@sinonjs/fake-timers` with `mock.timers.enable()` from `node:test`. - **`tests/README.md`**: Updated documentation to reflect `node --test` and the new snapshot file. - **`package.json`**: Remove `ava`, `@sinonjs/fake-timers`, and `execa` from devDependencies. Update test script to `c8 --100 node --test tests/index.js`. - **`tests/index.js.snapshot`**: New text-based snapshot file replacing binary `tests/snapshots/index.js.snap`. - **`tests/snapshots/`**: Deleted. All 22 test scenarios (66 subtests) pass with 100% code coverage. Closes #344 --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
37 lines
998 B
Markdown
37 lines
998 B
Markdown
# Tests
|
|
|
|
Add one test file per scenario. You can run them in isolation with:
|
|
|
|
```
|
|
node tests/post-token-set.test.js
|
|
```
|
|
|
|
All tests are run together in [tests/index.js](index.js), which can be executed with Node's built-in test runner
|
|
|
|
```
|
|
node --test tests/index.js
|
|
```
|
|
|
|
or with npm
|
|
|
|
```
|
|
npm test
|
|
```
|
|
|
|
## How the tests work
|
|
|
|
The output from the tests is captured into a snapshot ([tests/index.js.snapshot](index.js.snapshot)). It includes all requests sent by our scripts to verify it's working correctly and to prevent regressions.
|
|
|
|
To update snapshots after an intentional change:
|
|
|
|
```
|
|
node --test --test-update-snapshots tests/index.js
|
|
```
|
|
|
|
## How to add a new test
|
|
|
|
We have tests both for the `main.js` and `post.js` scripts.
|
|
|
|
- If you do not expect an error, take [main-token-permissions-set.test.js](tests/main-token-permissions-set.test.js) as a starting point.
|
|
- If your test has an expected error, take [main-missing-app-id.test.js](tests/main-missing-app-id.test.js) as a starting point.
|