qunitx-cli 0.5.1 → 0.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -2
- package/cli.js +1 -1
- package/deno.json +7 -0
- package/docs/browser-1-all-passed.png +0 -0
- package/docs/browser-1-failing.png +0 -0
- package/docs/browser-2-all-passed.png +0 -0
- package/docs/browser-2-filtered.png +0 -0
- package/docs/browser-3-expanded.png +0 -0
- package/docs/browser-3-filtered.png +0 -0
- package/docs/browser-4-expanded.png +0 -0
- package/docs/demo-math-test.failing.js +59 -0
- package/docs/demo-math-test.js +59 -0
- package/docs/demo.gif +0 -0
- package/docs/demo.tape +92 -0
- package/docs/make-demo-gif.sh +88 -0
- package/docs/qunitx-help-stdout.png +0 -0
- package/docs/take-browser-screenshots.js +226 -0
- package/docs/terminal.gif +0 -0
- package/lib/boilerplates/test.js +4 -4
- package/lib/commands/generate.js +5 -5
- package/lib/commands/init.js +12 -12
- package/lib/commands/run.js +2 -2
- package/lib/servers/http.js +5 -6
- package/lib/setup/browser.js +7 -15
- package/lib/setup/config.js +7 -7
- package/lib/setup/file-watcher.js +5 -10
- package/lib/setup/fs-tree.js +7 -7
- package/lib/setup/keyboard-events.js +1 -6
- package/lib/setup/test-file-paths.js +6 -6
- package/lib/setup/web-server.js +20 -19
- package/lib/setup/write-output-static-files.js +4 -4
- package/lib/tap/display-test-result.js +2 -2
- package/lib/utils/find-chrome.js +2 -2
- package/lib/utils/find-project-root.js +2 -2
- package/lib/utils/listen-to-keyboard-key.js +7 -7
- package/lib/utils/resolve-port-number-for.js +5 -7
- package/lib/utils/run-user-module.js +1 -1
- package/lib/utils/search-in-parent-directories.js +5 -5
- package/package.json +6 -5
package/README.md
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
# qunitx-cli
|
|
2
2
|
|
|
3
3
|
[](https://github.com/izelnakri/qunitx-cli/actions/workflows/ci.yml)
|
|
4
|
+
[](https://codecov.io/gh/izelnakri/qunitx-cli)
|
|
4
5
|
[](https://www.npmjs.com/package/qunitx-cli)
|
|
5
6
|
[](https://www.npmjs.com/package/qunitx-cli)
|
|
6
7
|
[](LICENSE)
|
|
@@ -8,7 +9,7 @@
|
|
|
8
9
|
Browser-based test runner for [QUnitX](https://github.com/izelnakri/qunitx) — bundles your JS/TS tests
|
|
9
10
|
with esbuild, runs them in headless Chrome, and streams TAP output to the terminal.
|
|
10
11
|
|
|
11
|
-

|
|
12
13
|
|
|
13
14
|
## Features
|
|
14
15
|
|
|
@@ -154,7 +155,7 @@ Options:
|
|
|
154
155
|
npm install
|
|
155
156
|
make check # lint + test (run before every commit)
|
|
156
157
|
make test # run tests only
|
|
157
|
-
make demo # regenerate demo
|
|
158
|
+
make demo # regenerate docs/demo.gif
|
|
158
159
|
make release LEVEL=patch # bump version, update changelog, tag, push
|
|
159
160
|
```
|
|
160
161
|
|
package/cli.js
CHANGED
package/deno.json
ADDED
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { module, test } from 'qunitx';
|
|
2
|
+
|
|
3
|
+
module('Math', (hooks) => {
|
|
4
|
+
hooks.beforeEach(function () {
|
|
5
|
+
this.numbers = [1, 2, 3];
|
|
6
|
+
});
|
|
7
|
+
|
|
8
|
+
test('equal and notEqual', (assert) => {
|
|
9
|
+
assert.equal(1 + 1, 2, 'addition');
|
|
10
|
+
assert.notEqual(1 + 1, 3);
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
test('strictEqual', (assert) => {
|
|
14
|
+
assert.strictEqual('hello', 'hello');
|
|
15
|
+
assert.notStrictEqual(1, '1', '1 !== "1" (type-strict)');
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
test('deepEqual — user profile sync', (assert) => {
|
|
19
|
+
const response = { user: { name: 'Alice', scores: [95, 88, 92] }, active: true };
|
|
20
|
+
const expected = { user: { name: 'Alice', scores: [95, 88, 92] }, active: true };
|
|
21
|
+
assert.deepEqual(response, expected, 'API response matches expected shape');
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
test('hooks: beforeEach resets state per test', function (assert) {
|
|
25
|
+
assert.deepEqual(this.numbers, [1, 2, 3]);
|
|
26
|
+
this.numbers.push(4);
|
|
27
|
+
assert.equal(this.numbers.length, 4);
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
module('Async', () => {
|
|
31
|
+
test('async/await', async (assert) => {
|
|
32
|
+
const data = await Promise.resolve({ id: 1, name: 'Alice' });
|
|
33
|
+
console.log(data.name, 'resolved in Chrome');
|
|
34
|
+
assert.propContains(data, { name: 'Alice' });
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
test('assert.rejects', async (assert) => {
|
|
38
|
+
await assert.rejects(Promise.reject(new TypeError('invalid')), TypeError);
|
|
39
|
+
});
|
|
40
|
+
});
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
module('Assertions', () => {
|
|
44
|
+
test('throws — match by constructor', (assert) => {
|
|
45
|
+
assert.throws(() => { throw new RangeError('out of bounds'); }, RangeError);
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
test('step/verifySteps — execution order', (assert) => {
|
|
49
|
+
assert.step('init');
|
|
50
|
+
assert.step('process');
|
|
51
|
+
assert.step('done');
|
|
52
|
+
assert.verifySteps(['init', 'process', 'done']);
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
test('propContains — partial object match', (assert) => {
|
|
56
|
+
const user = { id: 1, name: 'Alice', role: 'admin', active: true };
|
|
57
|
+
assert.propContains(user, { role: 'admin', active: true });
|
|
58
|
+
});
|
|
59
|
+
});
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { module, test } from 'qunitx';
|
|
2
|
+
|
|
3
|
+
module('Math', (hooks) => {
|
|
4
|
+
hooks.beforeEach(function () {
|
|
5
|
+
this.numbers = [1, 2, 3];
|
|
6
|
+
});
|
|
7
|
+
|
|
8
|
+
test('equal and notEqual', (assert) => {
|
|
9
|
+
assert.equal(1 + 1, 2, 'addition');
|
|
10
|
+
assert.notEqual(1 + 1, 3);
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
test('strictEqual', (assert) => {
|
|
14
|
+
assert.strictEqual('hello', 'hello');
|
|
15
|
+
assert.notStrictEqual(1, '1', '1 !== "1" (type-strict)');
|
|
16
|
+
});
|
|
17
|
+
|
|
18
|
+
test('deepEqual — user profile sync', (assert) => {
|
|
19
|
+
const response = { user: { name: 'Alice', scores: [95, 88, 92] }, active: true };
|
|
20
|
+
const expected = { user: { name: 'Alice', scores: [95, 88, 92] }, active: true };
|
|
21
|
+
assert.deepEqual(response, expected, 'API response matches expected shape');
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
test('hooks: beforeEach resets state per test', function (assert) {
|
|
25
|
+
assert.deepEqual(this.numbers, [1, 2, 3]);
|
|
26
|
+
this.numbers.push(4);
|
|
27
|
+
assert.equal(this.numbers.length, 4);
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
module('Async', () => {
|
|
31
|
+
test('async/await', async (assert) => {
|
|
32
|
+
const data = await Promise.resolve({ id: 1, name: 'Alice' });
|
|
33
|
+
console.log(data.name, 'resolved in Chrome');
|
|
34
|
+
assert.propContains(data, { name: 'Alice' });
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
test('assert.rejects', async (assert) => {
|
|
38
|
+
await assert.rejects(Promise.reject(new TypeError('invalid')), TypeError);
|
|
39
|
+
});
|
|
40
|
+
});
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
module('Assertions', () => {
|
|
44
|
+
test('throws — match by constructor', (assert) => {
|
|
45
|
+
assert.throws(() => { throw new RangeError('out of bounds'); }, RangeError);
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
test('step/verifySteps — execution order', (assert) => {
|
|
49
|
+
assert.step('init');
|
|
50
|
+
assert.step('process');
|
|
51
|
+
assert.step('done');
|
|
52
|
+
assert.verifySteps(['init', 'process', 'done']);
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
test('propContains — partial object match', (assert) => {
|
|
56
|
+
const user = { id: 1, name: 'Alice', role: 'admin', active: true };
|
|
57
|
+
assert.propContains(user, { role: 'admin', active: true });
|
|
58
|
+
});
|
|
59
|
+
});
|
package/docs/demo.gif
ADDED
|
Binary file
|
package/docs/demo.tape
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# QUnitX demo — terminal portion of the composite GIF
|
|
2
|
+
# Run: nix run nixpkgs#vhs -- docs/demo.tape
|
|
3
|
+
# Output: docs/terminal.gif (composited into docs/demo.gif by make-demo-gif.sh)
|
|
4
|
+
|
|
5
|
+
Output docs/terminal.gif
|
|
6
|
+
|
|
7
|
+
Set Shell "zsh"
|
|
8
|
+
Set FontSize 14
|
|
9
|
+
Set Width 700
|
|
10
|
+
Set Height 680
|
|
11
|
+
Set Theme "Dracula"
|
|
12
|
+
Set Padding 20
|
|
13
|
+
Set TypingSpeed 55ms
|
|
14
|
+
Set PlaybackSpeed 0.85
|
|
15
|
+
|
|
16
|
+
Hide
|
|
17
|
+
Type "setopt interactive_comments"
|
|
18
|
+
Enter
|
|
19
|
+
Type "alias qunitx=$(pwd)/cli.js"
|
|
20
|
+
Enter
|
|
21
|
+
Sleep 200ms
|
|
22
|
+
# Create failing version: copy demo-math-test.js with the score bug (88 → 87)
|
|
23
|
+
Type "cp docs/demo-math-test.js docs/demo-math-test.failing.js && sed -i '/const response/s/88/87/' docs/demo-math-test.failing.js"
|
|
24
|
+
Enter
|
|
25
|
+
Sleep 400ms
|
|
26
|
+
Show
|
|
27
|
+
|
|
28
|
+
# ── 1. Show the test file ─────────────────────────────────────────────────────
|
|
29
|
+
Type "bat --paging=never docs/demo-math-test.js"
|
|
30
|
+
Enter
|
|
31
|
+
Sleep 4000ms
|
|
32
|
+
|
|
33
|
+
Hide
|
|
34
|
+
Type "clear"
|
|
35
|
+
Enter
|
|
36
|
+
Show
|
|
37
|
+
|
|
38
|
+
# ── 2. qunitx --debug: headless Chrome, TAP output, browser console ───────────
|
|
39
|
+
Type "# qunitx: headless Chrome, streams TAP, pipes browser console"
|
|
40
|
+
Enter
|
|
41
|
+
Sleep 400ms
|
|
42
|
+
Type "qunitx docs/demo-math-test.failing.js --debug"
|
|
43
|
+
Enter
|
|
44
|
+
Sleep 9500ms
|
|
45
|
+
|
|
46
|
+
Hide
|
|
47
|
+
Type "clear"
|
|
48
|
+
Enter
|
|
49
|
+
Show
|
|
50
|
+
|
|
51
|
+
# ── 3. --failFast: stop immediately on the first failure ──────────────────────
|
|
52
|
+
Type "# --failFast: stop on the first failure"
|
|
53
|
+
Enter
|
|
54
|
+
Sleep 400ms
|
|
55
|
+
Type "qunitx docs/demo-math-test.failing.js --failFast"
|
|
56
|
+
Enter
|
|
57
|
+
Sleep 6000ms
|
|
58
|
+
|
|
59
|
+
Hide
|
|
60
|
+
Type "clear"
|
|
61
|
+
Enter
|
|
62
|
+
# Background: 'fix' the file 9 seconds from now — fires during the watch run
|
|
63
|
+
Type "(sleep 9 && cp docs/demo-math-test.js docs/demo-math-test.failing.js) &"
|
|
64
|
+
Enter
|
|
65
|
+
Sleep 200ms
|
|
66
|
+
Show
|
|
67
|
+
|
|
68
|
+
# ── 4. --watch: live fail → fix → pass cycle ──────────────────────────────────
|
|
69
|
+
Type "# --watch: re-runs on every file save"
|
|
70
|
+
Enter
|
|
71
|
+
Sleep 400ms
|
|
72
|
+
Type "qunitx docs/demo-math-test.failing.js --watch"
|
|
73
|
+
Enter
|
|
74
|
+
Sleep 4500ms
|
|
75
|
+
# Background fires ~9s after the hidden job was queued, ~5.2s after qunitx started.
|
|
76
|
+
# Initial failing run is done; file is replaced; watch detects change and re-runs.
|
|
77
|
+
Sleep 5500ms
|
|
78
|
+
Ctrl+C
|
|
79
|
+
Sleep 800ms
|
|
80
|
+
|
|
81
|
+
Hide
|
|
82
|
+
Type "clear"
|
|
83
|
+
Enter
|
|
84
|
+
Show
|
|
85
|
+
|
|
86
|
+
# ── 5. node --test: same file, same results ───────────────────────────────────
|
|
87
|
+
Type "# Same file in Node.js — zero extra config"
|
|
88
|
+
Enter
|
|
89
|
+
Sleep 400ms
|
|
90
|
+
Type "node --test docs/demo-math-test.js"
|
|
91
|
+
Enter
|
|
92
|
+
Sleep 5500ms
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Regenerates docs/demo.gif — the combined terminal + browser demo GIF.
|
|
3
|
+
#
|
|
4
|
+
# Prerequisites (available in the nix devShell):
|
|
5
|
+
# nix run nixpkgs#vhs — terminal recorder
|
|
6
|
+
# CHROME_BIN — path to Chromium binary
|
|
7
|
+
# ffmpeg, gifsicle — compositing and optimisation
|
|
8
|
+
#
|
|
9
|
+
# Usage:
|
|
10
|
+
# export CHROME_BIN=/nix/store/<hash>-chromium-<ver>/bin/chromium
|
|
11
|
+
# bash docs/make-demo-gif.sh
|
|
12
|
+
#
|
|
13
|
+
# Outputs:
|
|
14
|
+
# docs/terminal.gif — terminal-only animation (VHS)
|
|
15
|
+
# docs/browser-*.png — browser screenshots (puppeteer)
|
|
16
|
+
# docs/demo.gif — final composite (1000×500, ~500 KB)
|
|
17
|
+
|
|
18
|
+
set -euo pipefail
|
|
19
|
+
cd "$(dirname "$0")/.."
|
|
20
|
+
DOCS=docs
|
|
21
|
+
TMP=$(mktemp -d)
|
|
22
|
+
trap "rm -rf $TMP" EXIT
|
|
23
|
+
|
|
24
|
+
# ── 1. Terminal GIF via VHS ────────────────────────────────────────────────────
|
|
25
|
+
echo "==> Recording terminal animation (VHS)..."
|
|
26
|
+
nix run nixpkgs#vhs -- "$DOCS/demo.tape"
|
|
27
|
+
echo " terminal.gif: $(du -h "$DOCS/terminal.gif" | cut -f1)"
|
|
28
|
+
|
|
29
|
+
# ── 2. Browser screenshots via puppeteer ──────────────────────────────────────
|
|
30
|
+
echo "==> Taking browser screenshots..."
|
|
31
|
+
if [[ -z "${CHROME_BIN:-}" ]]; then
|
|
32
|
+
CHROME_BIN=$(nix eval --raw nixpkgs#chromium.outPath)/bin/chromium
|
|
33
|
+
fi
|
|
34
|
+
CHROME_BIN="$CHROME_BIN" node "$DOCS/take-browser-screenshots.js"
|
|
35
|
+
|
|
36
|
+
# ── 3. Get terminal duration ───────────────────────────────────────────────────
|
|
37
|
+
DURATION=$(ffprobe -v error -show_entries format=duration \
|
|
38
|
+
-of default=noprint_wrappers=1:nokey=1 "$DOCS/terminal.gif")
|
|
39
|
+
DURATION=${DURATION%.*}
|
|
40
|
+
|
|
41
|
+
# ── 4. Terminal: scale to 500×500, per-module palette, optimise ───────────────
|
|
42
|
+
echo "==> Scaling terminal to 500×500..."
|
|
43
|
+
ffmpeg -y -i "$DOCS/terminal.gif" \
|
|
44
|
+
-vf "fps=8,scale=500:500:flags=lanczos,pad=500:500:(ow-iw)/2:(oh-ih)/2,split[a][b];[a]palettegen=max_colors=200[p];[b][p]paletteuse" \
|
|
45
|
+
-t "$DURATION" -loop 0 "$TMP/terminal_small.gif" 2>/dev/null
|
|
46
|
+
nix run nixpkgs#gifsicle -- -O3 --lossy=80 "$TMP/terminal_small.gif" -o "$TMP/terminal_opt.gif" 2>/dev/null
|
|
47
|
+
|
|
48
|
+
# ── 5. Browser slideshow: scale to 500×500, 2fps ──────────────────────────────
|
|
49
|
+
# Frame timing:
|
|
50
|
+
# 1. Failing tests + deepEqual diff — 14s (give viewers time to read the diff)
|
|
51
|
+
# 2. All passing (simulated refresh) — 8s (quick "it's fixed!")
|
|
52
|
+
# 3. Filtered to Async module — 8s (shareable URL demo)
|
|
53
|
+
# 4. deepEqual test expanded — remainder
|
|
54
|
+
D1=14
|
|
55
|
+
D2=8
|
|
56
|
+
D3=8
|
|
57
|
+
D4=$(( DURATION - D1 - D2 - D3 ))
|
|
58
|
+
echo "==> Building browser slideshow (${D1}s / ${D2}s / ${D3}s / ${D4}s)..."
|
|
59
|
+
cat > "$TMP/browser_list.txt" << EOF
|
|
60
|
+
file '$(realpath $DOCS/browser-1-failing.png)'
|
|
61
|
+
duration $D1
|
|
62
|
+
file '$(realpath $DOCS/browser-2-all-passed.png)'
|
|
63
|
+
duration $D2
|
|
64
|
+
file '$(realpath $DOCS/browser-3-filtered.png)'
|
|
65
|
+
duration $D3
|
|
66
|
+
file '$(realpath $DOCS/browser-4-expanded.png)'
|
|
67
|
+
duration $D4
|
|
68
|
+
file '$(realpath $DOCS/browser-4-expanded.png)'
|
|
69
|
+
EOF
|
|
70
|
+
|
|
71
|
+
ffmpeg -y -f concat -safe 0 -i "$TMP/browser_list.txt" \
|
|
72
|
+
-vf "fps=2,scale=500:500:flags=lanczos,pad=500:500:(ow-iw)/2:(oh-ih)/2,split[a][b];[a]palettegen=max_colors=200[p];[b][p]paletteuse" \
|
|
73
|
+
-t "$DURATION" -loop 0 "$TMP/browser_small.gif" 2>/dev/null
|
|
74
|
+
nix run nixpkgs#gifsicle -- -O3 --lossy=80 "$TMP/browser_small.gif" -o "$TMP/browser_opt.gif" 2>/dev/null
|
|
75
|
+
|
|
76
|
+
# ── 6. Composite: hstack with shared palette ──────────────────────────────────
|
|
77
|
+
echo "==> Compositing side-by-side..."
|
|
78
|
+
ffmpeg -y -i "$TMP/terminal_opt.gif" -i "$TMP/browser_opt.gif" \
|
|
79
|
+
-filter_complex \
|
|
80
|
+
"[0:v][1:v]hstack=inputs=2,split[a][b]; \
|
|
81
|
+
[a]palettegen=max_colors=128[p];[b][p]paletteuse=dither=bayer:bayer_scale=5" \
|
|
82
|
+
-t "$DURATION" -loop 0 "$TMP/combined.gif" 2>/dev/null
|
|
83
|
+
|
|
84
|
+
# ── 7. Final optimise ─────────────────────────────────────────────────────────
|
|
85
|
+
echo "==> Optimising with gifsicle..."
|
|
86
|
+
nix run nixpkgs#gifsicle -- -O3 --lossy=100 "$TMP/combined.gif" -o "$DOCS/demo.gif" 2>/dev/null
|
|
87
|
+
|
|
88
|
+
echo "==> Done: $DOCS/demo.gif ($(du -h "$DOCS/demo.gif" | cut -f1))"
|
|
Binary file
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Serves QUnit test pages and captures screenshots for the demo GIF.
|
|
3
|
+
// Usage: CHROME_BIN=... node docs/take-browser-screenshots.js
|
|
4
|
+
// Output: docs/browser-{1-failing,2-all-passed,3-filtered,4-expanded}.png
|
|
5
|
+
|
|
6
|
+
import http from 'node:http';
|
|
7
|
+
import fs from 'node:fs/promises';
|
|
8
|
+
import path from 'node:path';
|
|
9
|
+
import { fileURLToPath } from 'node:url';
|
|
10
|
+
import puppeteer from 'puppeteer';
|
|
11
|
+
|
|
12
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
13
|
+
const ROOT = path.resolve(__dirname, '..');
|
|
14
|
+
const CHROME =
|
|
15
|
+
process.env.CHROME_BIN ||
|
|
16
|
+
`${process.env.HOME}/.cache/puppeteer/chrome/linux-146.0.7680.66/chrome-linux64/chrome`;
|
|
17
|
+
|
|
18
|
+
const qunitJS = await fs.readFile(path.join(ROOT, 'vendor/qunit.js'), 'utf8');
|
|
19
|
+
const qunitCSS = await fs.readFile(path.join(ROOT, 'vendor/qunit.css'), 'utf8');
|
|
20
|
+
|
|
21
|
+
// ── Shared test suite ────────────────────────────────────────────────────────
|
|
22
|
+
// Bug is in deepEqual: scores[1] is 87 in "actual" but 88 in "expected".
|
|
23
|
+
// Swap BUGGY_VALUE → FIXED_VALUE to simulate saving the fix.
|
|
24
|
+
const BUGGY_VALUE = '87';
|
|
25
|
+
const FIXED_VALUE = '88';
|
|
26
|
+
|
|
27
|
+
const makeSuite = (scoreValue) => `
|
|
28
|
+
QUnit.module('Assertions', (hooks) => {
|
|
29
|
+
QUnit.test('ok / notOk', (assert) => {
|
|
30
|
+
assert.ok(1, 'truthy value passes');
|
|
31
|
+
assert.notOk(0, 'falsy value passes');
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
QUnit.test('equal / strictEqual', (assert) => {
|
|
35
|
+
assert.equal(2 + 2, 4, 'addition');
|
|
36
|
+
assert.strictEqual('hello', 'hello');
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
QUnit.test('deepEqual – user profile sync', (assert) => {
|
|
40
|
+
const response = { user: { name: 'Alice', scores: [95, ${scoreValue}, 92] }, active: true };
|
|
41
|
+
const expected = { user: { name: 'Alice', scores: [95, 88, 92] }, active: true };
|
|
42
|
+
assert.deepEqual(response, expected, 'API response matches expected shape');
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
QUnit.test('throws – match by constructor', (assert) => {
|
|
46
|
+
assert.throws(() => { throw new TypeError('bad input'); }, TypeError);
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
QUnit.test('propContains – partial object match', (assert) => {
|
|
50
|
+
assert.propContains({ id: 1, name: 'Alice', role: 'admin' }, { role: 'admin' });
|
|
51
|
+
});
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
QUnit.module('Async', (hooks) => {
|
|
55
|
+
QUnit.test('async/await', async (assert) => {
|
|
56
|
+
const result = await Promise.resolve(42);
|
|
57
|
+
assert.strictEqual(result, 42, 'resolved to 42');
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
QUnit.test('assert.async() – callback style', (assert) => {
|
|
61
|
+
const done = assert.async();
|
|
62
|
+
setTimeout(() => {
|
|
63
|
+
assert.ok(true, 'callback fired');
|
|
64
|
+
done();
|
|
65
|
+
}, 10);
|
|
66
|
+
});
|
|
67
|
+
|
|
68
|
+
QUnit.test('rejects – async error handling', async (assert) => {
|
|
69
|
+
await assert.rejects(Promise.reject(new RangeError('out of bounds')), RangeError);
|
|
70
|
+
});
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
QUnit.module('Hooks', (hooks) => {
|
|
74
|
+
hooks.beforeEach(function () {
|
|
75
|
+
this.user = { name: 'Alice', loggedIn: false };
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
QUnit.test('beforeEach sets up fresh state', function (assert) {
|
|
79
|
+
assert.strictEqual(this.user.name, 'Alice');
|
|
80
|
+
assert.false(this.user.loggedIn, 'starts logged out');
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
QUnit.test('mutations do not leak between tests', function (assert) {
|
|
84
|
+
this.user.loggedIn = true;
|
|
85
|
+
assert.true(this.user.loggedIn, 'mutated in this test only');
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
QUnit.module('Nested Hooks', (innerHooks) => {
|
|
89
|
+
innerHooks.beforeEach(function () {
|
|
90
|
+
this.role = 'admin';
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
QUnit.test('inner beforeEach stacks on outer', function (assert) {
|
|
94
|
+
assert.strictEqual(this.user.name, 'Alice', 'outer beforeEach ran');
|
|
95
|
+
assert.strictEqual(this.role, 'admin', 'inner beforeEach also ran');
|
|
96
|
+
});
|
|
97
|
+
});
|
|
98
|
+
});
|
|
99
|
+
`;
|
|
100
|
+
|
|
101
|
+
const makeHTML = (tests) => `<!DOCTYPE html>
|
|
102
|
+
<html>
|
|
103
|
+
<head>
|
|
104
|
+
<meta charset="utf-8">
|
|
105
|
+
<meta name="viewport" content="width=device-width">
|
|
106
|
+
<title>QUnitX Demo Tests</title>
|
|
107
|
+
<style>${qunitCSS}</style>
|
|
108
|
+
<style>
|
|
109
|
+
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }
|
|
110
|
+
#qunit-header { background: #1c1c1e; }
|
|
111
|
+
</style>
|
|
112
|
+
</head>
|
|
113
|
+
<body>
|
|
114
|
+
<div id="qunit"></div>
|
|
115
|
+
<div id="qunit-fixture"></div>
|
|
116
|
+
<script>${qunitJS}</script>
|
|
117
|
+
<script>${tests}</script>
|
|
118
|
+
</body>
|
|
119
|
+
</html>`;
|
|
120
|
+
|
|
121
|
+
// ── Helpers ──────────────────────────────────────────────────────────────────
|
|
122
|
+
function createServer(html) {
|
|
123
|
+
const server = http.createServer((req, res) => {
|
|
124
|
+
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
|
|
125
|
+
res.end(html);
|
|
126
|
+
});
|
|
127
|
+
return new Promise((resolve) => server.listen(0, '127.0.0.1', () => resolve(server)));
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
async function waitForResults(page, timeout = 15000) {
|
|
131
|
+
await page.waitForFunction(
|
|
132
|
+
() => {
|
|
133
|
+
const banner = document.getElementById('qunit-banner');
|
|
134
|
+
return (
|
|
135
|
+
banner &&
|
|
136
|
+
(banner.classList.contains('qunit-pass') || banner.classList.contains('qunit-fail'))
|
|
137
|
+
);
|
|
138
|
+
},
|
|
139
|
+
{ timeout },
|
|
140
|
+
);
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
// ── Puppeteer ────────────────────────────────────────────────────────────────
|
|
144
|
+
const browser = await puppeteer.launch({
|
|
145
|
+
executablePath: CHROME,
|
|
146
|
+
headless: true,
|
|
147
|
+
args: ['--no-sandbox', '--disable-gpu', '--window-size=1200,860'],
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
const page = await browser.newPage();
|
|
151
|
+
await page.setViewport({ width: 700, height: 680, deviceScaleFactor: 1 });
|
|
152
|
+
|
|
153
|
+
// ── Screenshot 1: Failing tests — deepEqual diff visible ─────────────────────
|
|
154
|
+
const failingServer = await createServer(makeHTML(makeSuite(BUGGY_VALUE)));
|
|
155
|
+
const failingURL = `http://127.0.0.1:${failingServer.address().port}/`;
|
|
156
|
+
console.log(`Serving failing tests at ${failingURL}`);
|
|
157
|
+
|
|
158
|
+
await page.goto(failingURL, { waitUntil: 'networkidle0' });
|
|
159
|
+
await waitForResults(page);
|
|
160
|
+
|
|
161
|
+
// Expand the failing test so the deepEqual diff is in view
|
|
162
|
+
const failingItem = await page.$('#qunit-tests > li.fail');
|
|
163
|
+
if (failingItem) {
|
|
164
|
+
const toggle = await failingItem.$('strong');
|
|
165
|
+
if (toggle) {
|
|
166
|
+
await toggle.click();
|
|
167
|
+
await new Promise((r) => setTimeout(r, 600));
|
|
168
|
+
}
|
|
169
|
+
// Scroll the failing test to the top so diff is fully visible
|
|
170
|
+
await page.evaluate((el) => el.scrollIntoView({ block: 'start' }), failingItem);
|
|
171
|
+
await new Promise((r) => setTimeout(r, 300));
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
await page.screenshot({ path: path.join(__dirname, 'browser-1-failing.png') });
|
|
175
|
+
console.log('Screenshot 1: failing (deepEqual diff) ✓');
|
|
176
|
+
failingServer.close();
|
|
177
|
+
|
|
178
|
+
// ── Screenshot 2: All passing — simulates browser refresh after fixing the bug ──
|
|
179
|
+
const passingServer = await createServer(makeHTML(makeSuite(FIXED_VALUE)));
|
|
180
|
+
const passingURL = `http://127.0.0.1:${passingServer.address().port}/`;
|
|
181
|
+
console.log(`Serving passing tests at ${passingURL}`);
|
|
182
|
+
|
|
183
|
+
await page.goto(passingURL, { waitUntil: 'networkidle0' });
|
|
184
|
+
await waitForResults(page);
|
|
185
|
+
await page.evaluate(() => window.scrollTo(0, 0));
|
|
186
|
+
await page.screenshot({ path: path.join(__dirname, 'browser-2-all-passed.png') });
|
|
187
|
+
console.log('Screenshot 2: all passed ✓');
|
|
188
|
+
|
|
189
|
+
// ── Screenshot 3: Filtered to "Async" module — shareable URL demo ────────────
|
|
190
|
+
const asyncModuleId = await page.evaluate(() => {
|
|
191
|
+
if (typeof QUnit !== 'undefined' && QUnit.config && QUnit.config.modules) {
|
|
192
|
+
const m = QUnit.config.modules.find((m) => m.name === 'Async');
|
|
193
|
+
return m ? m.moduleId : null;
|
|
194
|
+
}
|
|
195
|
+
return null;
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
if (asyncModuleId) {
|
|
199
|
+
await page.goto(`${passingURL}?moduleId=${asyncModuleId}`, { waitUntil: 'networkidle0' });
|
|
200
|
+
await waitForResults(page);
|
|
201
|
+
}
|
|
202
|
+
await page.evaluate(() => window.scrollTo(0, 0));
|
|
203
|
+
await page.screenshot({ path: path.join(__dirname, 'browser-3-filtered.png') });
|
|
204
|
+
console.log('Screenshot 3: filtered (Async module) ✓');
|
|
205
|
+
|
|
206
|
+
// ── Screenshot 4: Back to all tests, deepEqual test expanded ─────────────────
|
|
207
|
+
await page.goto(passingURL, { waitUntil: 'networkidle0' });
|
|
208
|
+
await waitForResults(page);
|
|
209
|
+
|
|
210
|
+
// Expand the deepEqual test (3rd test in Assertions) to show passing assertion detail
|
|
211
|
+
const deepEqualItem = await page.$('#qunit-tests > li:nth-child(3)');
|
|
212
|
+
if (deepEqualItem) {
|
|
213
|
+
const toggle = await deepEqualItem.$('strong');
|
|
214
|
+
if (toggle) {
|
|
215
|
+
await toggle.click();
|
|
216
|
+
await new Promise((r) => setTimeout(r, 400));
|
|
217
|
+
}
|
|
218
|
+
await page.evaluate((el) => el.scrollIntoView({ block: 'start' }), deepEqualItem);
|
|
219
|
+
await new Promise((r) => setTimeout(r, 200));
|
|
220
|
+
}
|
|
221
|
+
await page.screenshot({ path: path.join(__dirname, 'browser-4-expanded.png') });
|
|
222
|
+
console.log('Screenshot 4: deepEqual expanded (passing) ✓');
|
|
223
|
+
|
|
224
|
+
passingServer.close();
|
|
225
|
+
await browser.close();
|
|
226
|
+
console.log('Done. Screenshots saved to docs/');
|
|
Binary file
|
package/lib/boilerplates/test.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { module, test } from 'qunitx';
|
|
2
2
|
|
|
3
|
-
module('{{moduleName}}', function (
|
|
3
|
+
module('{{moduleName}}', function (_hooks) {
|
|
4
4
|
test('assert true works', function (assert) {
|
|
5
5
|
assert.expect(3);
|
|
6
6
|
assert.ok(true);
|
|
@@ -11,11 +11,11 @@ module('{{moduleName}}', function (hooks) {
|
|
|
11
11
|
test('async test finishes', async function (assert) {
|
|
12
12
|
assert.expect(3);
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
new Promise((resolve
|
|
14
|
+
const wait = () =>
|
|
15
|
+
new Promise((resolve) => {
|
|
16
16
|
setTimeout(() => resolve(true), 50);
|
|
17
17
|
});
|
|
18
|
-
|
|
18
|
+
const result = await wait();
|
|
19
19
|
|
|
20
20
|
assert.ok(true);
|
|
21
21
|
assert.equal(true, result);
|
package/lib/commands/generate.js
CHANGED
|
@@ -8,9 +8,9 @@ import pathExists from '../utils/path-exists.js';
|
|
|
8
8
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
9
9
|
|
|
10
10
|
export default async function () {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
11
|
+
const projectRoot = await findProjectRoot();
|
|
12
|
+
const moduleName = process.argv[3]; // TODO: classify this maybe in future
|
|
13
|
+
const path =
|
|
14
14
|
process.argv[3].endsWith('.js') || process.argv[3].endsWith('.ts')
|
|
15
15
|
? `${projectRoot}/${process.argv[3]}`
|
|
16
16
|
: `${projectRoot}/${process.argv[3]}.js`;
|
|
@@ -19,8 +19,8 @@ export default async function () {
|
|
|
19
19
|
return console.log(`${path} already exists!`);
|
|
20
20
|
}
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
22
|
+
const testJSContent = await fs.readFile(`${__dirname}/../boilerplates/test.js`);
|
|
23
|
+
const targetFolderPaths = path.split('/');
|
|
24
24
|
|
|
25
25
|
targetFolderPaths.pop();
|
|
26
26
|
|
package/lib/commands/init.js
CHANGED
|
@@ -8,9 +8,9 @@ import defaultProjectConfigValues from '../boilerplates/default-project-config-v
|
|
|
8
8
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
9
9
|
|
|
10
10
|
export default async function () {
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
11
|
+
const projectRoot = await findProjectRoot();
|
|
12
|
+
const oldPackageJSON = JSON.parse(await fs.readFile(`${projectRoot}/package.json`));
|
|
13
|
+
const htmlPaths = process.argv.slice(2).reduce(
|
|
14
14
|
(result, arg) => {
|
|
15
15
|
if (arg.endsWith('.html')) {
|
|
16
16
|
result.push(arg);
|
|
@@ -20,7 +20,7 @@ export default async function () {
|
|
|
20
20
|
},
|
|
21
21
|
oldPackageJSON.qunitx && oldPackageJSON.qunitx.htmlPaths ? oldPackageJSON.qunitx.htmlPaths : [],
|
|
22
22
|
);
|
|
23
|
-
|
|
23
|
+
const newQunitxConfig = Object.assign(
|
|
24
24
|
defaultProjectConfigValues,
|
|
25
25
|
htmlPaths.length > 0 ? { htmlPaths } : { htmlPaths: ['test/tests.html'] },
|
|
26
26
|
oldPackageJSON.qunitx,
|
|
@@ -34,20 +34,20 @@ export default async function () {
|
|
|
34
34
|
}
|
|
35
35
|
|
|
36
36
|
async function writeTestsHTML(projectRoot, newQunitxConfig, oldPackageJSON) {
|
|
37
|
-
|
|
37
|
+
const testHTMLTemplateBuffer = await fs.readFile(`${__dirname}/../boilerplates/setup/tests.hbs`);
|
|
38
38
|
|
|
39
39
|
return await Promise.all(
|
|
40
40
|
newQunitxConfig.htmlPaths.map(async (htmlPath) => {
|
|
41
|
-
|
|
41
|
+
const targetPath = `${projectRoot}/${htmlPath}`;
|
|
42
42
|
if (await pathExists(targetPath)) {
|
|
43
43
|
return console.log(`${htmlPath} already exists`);
|
|
44
44
|
} else {
|
|
45
|
-
|
|
46
|
-
|
|
45
|
+
const targetDirectory = path.dirname(targetPath);
|
|
46
|
+
const _targetOutputPath = path.relative(
|
|
47
47
|
targetDirectory,
|
|
48
48
|
`${projectRoot}/${newQunitxConfig.output}/tests.js`,
|
|
49
49
|
);
|
|
50
|
-
|
|
50
|
+
const testHTMLTemplate = testHTMLTemplateBuffer
|
|
51
51
|
.toString()
|
|
52
52
|
.replace('{{applicationName}}', oldPackageJSON.name);
|
|
53
53
|
|
|
@@ -61,15 +61,15 @@ async function writeTestsHTML(projectRoot, newQunitxConfig, oldPackageJSON) {
|
|
|
61
61
|
}
|
|
62
62
|
|
|
63
63
|
async function rewritePackageJSON(projectRoot, newQunitxConfig, oldPackageJSON) {
|
|
64
|
-
|
|
64
|
+
const newPackageJSON = Object.assign(oldPackageJSON, { qunitx: newQunitxConfig });
|
|
65
65
|
|
|
66
66
|
await fs.writeFile(`${projectRoot}/package.json`, JSON.stringify(newPackageJSON, null, 2));
|
|
67
67
|
}
|
|
68
68
|
|
|
69
69
|
async function writeTSConfigIfNeeded(projectRoot) {
|
|
70
|
-
|
|
70
|
+
const targetPath = `${projectRoot}/tsconfig.json`;
|
|
71
71
|
if (!(await pathExists(targetPath))) {
|
|
72
|
-
|
|
72
|
+
const tsConfigTemplateBuffer = await fs.readFile(
|
|
73
73
|
`${__dirname}/../boilerplates/setup/tsconfig.json`,
|
|
74
74
|
);
|
|
75
75
|
|
package/lib/commands/run.js
CHANGED
|
@@ -146,7 +146,7 @@ export default async function (config) {
|
|
|
146
146
|
async function buildCachedContent(config, htmlPaths) {
|
|
147
147
|
const htmlBuffers = await Promise.all(config.htmlPaths.map((htmlPath) => fs.readFile(htmlPath)));
|
|
148
148
|
const cachedContent = htmlPaths.reduce(
|
|
149
|
-
(result,
|
|
149
|
+
(result, _htmlPath, index) => {
|
|
150
150
|
const filePath = config.htmlPaths[index];
|
|
151
151
|
const html = htmlBuffers[index].toString();
|
|
152
152
|
|
|
@@ -208,7 +208,7 @@ function splitIntoGroups(files, groupCount) {
|
|
|
208
208
|
return groups.filter((g) => g.length > 0);
|
|
209
209
|
}
|
|
210
210
|
|
|
211
|
-
function logWatcherAndKeyboardShortcutInfo(config,
|
|
211
|
+
function logWatcherAndKeyboardShortcutInfo(config, _server) {
|
|
212
212
|
console.log(
|
|
213
213
|
'#',
|
|
214
214
|
kleur.blue(`Watching files... You can browse the tests on http://localhost:${config.port} ...`),
|
package/lib/servers/http.js
CHANGED
|
@@ -15,14 +15,13 @@ export const MIME_TYPES = {
|
|
|
15
15
|
|
|
16
16
|
export default class HTTPServer {
|
|
17
17
|
static serve(config = { port: 1234 }, handler) {
|
|
18
|
-
|
|
19
|
-
|
|
18
|
+
const onListen = config.onListen || ((_server) => {});
|
|
19
|
+
const onError = config.onError || ((_error) => {});
|
|
20
20
|
|
|
21
21
|
return new Promise((resolve, reject) => {
|
|
22
|
-
|
|
22
|
+
const server = http.createServer((req, res) => {
|
|
23
23
|
return handler(req, res);
|
|
24
24
|
});
|
|
25
|
-
server = server;
|
|
26
25
|
server
|
|
27
26
|
.on('error', (error) => {
|
|
28
27
|
onError(error);
|
|
@@ -221,7 +220,7 @@ export default class HTTPServer {
|
|
|
221
220
|
return true;
|
|
222
221
|
}
|
|
223
222
|
|
|
224
|
-
buildRegexPattern(path,
|
|
223
|
+
buildRegexPattern(path, _paramNames) {
|
|
225
224
|
let regexPattern = path.replace(/:[^/]+/g, '([^/]+)');
|
|
226
225
|
regexPattern = regexPattern.replace(/\//g, '\\/');
|
|
227
226
|
|
|
@@ -235,7 +234,7 @@ export default class HTTPServer {
|
|
|
235
234
|
return paramMatches ? paramMatches.map((match) => match.slice(1)) : [];
|
|
236
235
|
}
|
|
237
236
|
|
|
238
|
-
extractParams(route,
|
|
237
|
+
extractParams(route, _url) {
|
|
239
238
|
const { paramNames, paramValues } = route;
|
|
240
239
|
const params = {};
|
|
241
240
|
|
package/lib/setup/browser.js
CHANGED
|
@@ -13,7 +13,7 @@ export default async function setupBrowser(
|
|
|
13
13
|
cachedContent,
|
|
14
14
|
existingBrowser = null,
|
|
15
15
|
) {
|
|
16
|
-
|
|
16
|
+
const [server, browser] = await Promise.all([
|
|
17
17
|
setupWebServer(config, cachedContent),
|
|
18
18
|
existingBrowser
|
|
19
19
|
? Promise.resolve(existingBrowser)
|
|
@@ -29,7 +29,7 @@ export default async function setupBrowser(
|
|
|
29
29
|
headless: true,
|
|
30
30
|
}),
|
|
31
31
|
]);
|
|
32
|
-
|
|
32
|
+
const [page] = await Promise.all([browser.newPage(), bindServerToPort(server, config)]);
|
|
33
33
|
|
|
34
34
|
page.on('console', async (msg) => {
|
|
35
35
|
if (config.debug) {
|
|
@@ -39,20 +39,12 @@ export default async function setupBrowser(
|
|
|
39
39
|
}
|
|
40
40
|
});
|
|
41
41
|
page.on('error', (msg) => {
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
} catch (e) {
|
|
45
|
-
console.error(e, e.stack);
|
|
46
|
-
console.log(e, e.stack);
|
|
47
|
-
}
|
|
42
|
+
console.error(msg, msg.stack);
|
|
43
|
+
console.log(msg, msg.stack);
|
|
48
44
|
});
|
|
49
|
-
page.on('pageerror',
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
} catch (e) {
|
|
53
|
-
console.log(e.toString());
|
|
54
|
-
console.error(e.toString());
|
|
55
|
-
}
|
|
45
|
+
page.on('pageerror', (error) => {
|
|
46
|
+
console.log(error.toString());
|
|
47
|
+
console.error(error.toString());
|
|
56
48
|
});
|
|
57
49
|
|
|
58
50
|
return { server, browser, page };
|
package/lib/setup/config.js
CHANGED
|
@@ -6,11 +6,11 @@ import setupTestFilePaths from './test-file-paths.js';
|
|
|
6
6
|
import parseCliFlags from '../utils/parse-cli-flags.js';
|
|
7
7
|
|
|
8
8
|
export default async function setupConfig() {
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
9
|
+
const projectRoot = await findProjectRoot();
|
|
10
|
+
const cliConfigFlags = parseCliFlags(projectRoot);
|
|
11
|
+
const projectPackageJSON = await readConfigFromPackageJSON(projectRoot);
|
|
12
|
+
const inputs = cliConfigFlags.inputs.concat(readInputsFromPackageJSON(projectPackageJSON));
|
|
13
|
+
const config = {
|
|
14
14
|
...defaultProjectConfigValues,
|
|
15
15
|
htmlPaths: [],
|
|
16
16
|
...projectPackageJSON.qunitx,
|
|
@@ -28,7 +28,7 @@ export default async function setupConfig() {
|
|
|
28
28
|
}
|
|
29
29
|
|
|
30
30
|
async function readConfigFromPackageJSON(projectRoot) {
|
|
31
|
-
|
|
31
|
+
const packageJSON = await fs.readFile(`${projectRoot}/package.json`);
|
|
32
32
|
|
|
33
33
|
return JSON.parse(packageJSON.toString());
|
|
34
34
|
}
|
|
@@ -38,7 +38,7 @@ function normalizeHTMLPaths(projectRoot, htmlPaths) {
|
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
function readInputsFromPackageJSON(packageJSON) {
|
|
41
|
-
|
|
41
|
+
const qunitx = packageJSON.qunitx;
|
|
42
42
|
|
|
43
43
|
return qunitx && qunitx.inputs ? qunitx.inputs : [];
|
|
44
44
|
}
|
|
@@ -1,14 +1,9 @@
|
|
|
1
1
|
import chokidar from 'chokidar';
|
|
2
2
|
import kleur from 'kleur';
|
|
3
3
|
|
|
4
|
-
export default
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
onEventFunc,
|
|
8
|
-
onFinishFunc,
|
|
9
|
-
) {
|
|
10
|
-
let extensions = ['js', 'ts'];
|
|
11
|
-
let fileWatchers = testFileLookupPaths.reduce((watcher, watchPath) => {
|
|
4
|
+
export default function setupFileWatchers(testFileLookupPaths, config, onEventFunc, onFinishFunc) {
|
|
5
|
+
const extensions = ['js', 'ts'];
|
|
6
|
+
const fileWatchers = testFileLookupPaths.reduce((watcher, watchPath) => {
|
|
12
7
|
return Object.assign(watcher, {
|
|
13
8
|
[watchPath]: chokidar.watch(watchPath, { ignoreInitial: true }).on('all', (event, path) => {
|
|
14
9
|
if (extensions.some((extension) => path.endsWith(extension))) {
|
|
@@ -31,7 +26,7 @@ export default async function setupFileWatchers(
|
|
|
31
26
|
if (!global.chokidarBuild) {
|
|
32
27
|
global.chokidarBuild = true;
|
|
33
28
|
|
|
34
|
-
|
|
29
|
+
const result = extensions.some((extension) => path.endsWith(extension))
|
|
35
30
|
? onEventFunc(event, path)
|
|
36
31
|
: null;
|
|
37
32
|
|
|
@@ -72,7 +67,7 @@ function mutateFSTree(fsTree, event, path) {
|
|
|
72
67
|
} else if (event === 'unlink') {
|
|
73
68
|
delete fsTree[path];
|
|
74
69
|
} else if (event === 'unlinkDir') {
|
|
75
|
-
|
|
70
|
+
const targetPaths = Object.keys(config.fsTree).filter((treePath) => treePath.startsWith(path));
|
|
76
71
|
|
|
77
72
|
targetPaths.forEach((path) => delete config.fsTree[path]);
|
|
78
73
|
}
|
package/lib/setup/fs-tree.js
CHANGED
|
@@ -2,19 +2,19 @@ import fs from 'node:fs/promises';
|
|
|
2
2
|
import picomatch from 'picomatch';
|
|
3
3
|
import recursiveLookup from 'recursive-lookup';
|
|
4
4
|
|
|
5
|
-
export default async function buildFSTree(fileAbsolutePaths,
|
|
6
|
-
|
|
7
|
-
|
|
5
|
+
export default async function buildFSTree(fileAbsolutePaths, _config = {}) {
|
|
6
|
+
const targetExtensions = ['js', 'ts'];
|
|
7
|
+
const fsTree = {};
|
|
8
8
|
|
|
9
9
|
await Promise.all(
|
|
10
10
|
fileAbsolutePaths.map(async (fileAbsolutePath) => {
|
|
11
|
-
|
|
11
|
+
const glob = picomatch.scan(fileAbsolutePath);
|
|
12
12
|
|
|
13
13
|
// TODO: maybe allow absolute path references
|
|
14
14
|
|
|
15
15
|
try {
|
|
16
16
|
if (glob.isGlob) {
|
|
17
|
-
|
|
17
|
+
const fileNames = await recursiveLookup(glob.base, (path) => {
|
|
18
18
|
return targetExtensions.some((extension) => path.endsWith(extension));
|
|
19
19
|
});
|
|
20
20
|
|
|
@@ -24,12 +24,12 @@ export default async function buildFSTree(fileAbsolutePaths, config = {}) {
|
|
|
24
24
|
}
|
|
25
25
|
});
|
|
26
26
|
} else {
|
|
27
|
-
|
|
27
|
+
const entry = await fs.stat(fileAbsolutePath);
|
|
28
28
|
|
|
29
29
|
if (entry.isFile()) {
|
|
30
30
|
fsTree[fileAbsolutePath] = null;
|
|
31
31
|
} else if (entry.isDirectory()) {
|
|
32
|
-
|
|
32
|
+
const fileNames = await recursiveLookup(glob.base, (path) => {
|
|
33
33
|
return targetExtensions.some((extension) => path.endsWith(extension));
|
|
34
34
|
});
|
|
35
35
|
|
|
@@ -27,11 +27,6 @@ export default function setupKeyboardEvents(config, cachedContent, connections)
|
|
|
27
27
|
});
|
|
28
28
|
}
|
|
29
29
|
|
|
30
|
-
function abortBrowserQUnit(
|
|
30
|
+
function abortBrowserQUnit(_config, connections) {
|
|
31
31
|
connections.server.publish('abort', 'abort');
|
|
32
32
|
}
|
|
33
|
-
|
|
34
|
-
function abortNodejsQUnit(config) {
|
|
35
|
-
window.QUnit.config.queue.length = 0;
|
|
36
|
-
config.aborted = true;
|
|
37
|
-
}
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import picomatch from 'picomatch';
|
|
2
2
|
|
|
3
|
-
export default function setupTestFilePaths(
|
|
3
|
+
export default function setupTestFilePaths(_projectRoot, inputs) {
|
|
4
4
|
// NOTE: very complex algorithm, order is very important
|
|
5
|
-
|
|
5
|
+
const [folders, filesWithGlob, filesWithoutGlob] = inputs.reduce(
|
|
6
6
|
(result, input) => {
|
|
7
|
-
|
|
7
|
+
const isGlob = picomatch.scan(input).isGlob;
|
|
8
8
|
|
|
9
9
|
if (!pathIsFile(input)) {
|
|
10
10
|
result[0].push({
|
|
@@ -25,7 +25,7 @@ export default function setupTestFilePaths(projectRoot, inputs) {
|
|
|
25
25
|
[[], [], []],
|
|
26
26
|
);
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
const result = folders.reduce((folderResult, folder) => {
|
|
29
29
|
if (!pathIsIncludedInPaths(folders, folder)) {
|
|
30
30
|
folderResult.push(folder);
|
|
31
31
|
}
|
|
@@ -48,7 +48,7 @@ export default function setupTestFilePaths(projectRoot, inputs) {
|
|
|
48
48
|
}
|
|
49
49
|
|
|
50
50
|
function pathIsFile(path) {
|
|
51
|
-
|
|
51
|
+
const inputs = path.split('/');
|
|
52
52
|
|
|
53
53
|
return inputs[inputs.length - 1].includes('.');
|
|
54
54
|
}
|
|
@@ -59,7 +59,7 @@ function pathIsIncludedInPaths(paths, targetPath) {
|
|
|
59
59
|
return false;
|
|
60
60
|
}
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
const globFormat = buildGlobFormat(path);
|
|
63
63
|
|
|
64
64
|
return picomatch.isMatch(targetPath.input, globFormat, { bash: true });
|
|
65
65
|
});
|
package/lib/setup/web-server.js
CHANGED
|
@@ -7,7 +7,7 @@ import HTTPServer, { MIME_TYPES } from '../servers/http.js';
|
|
|
7
7
|
|
|
8
8
|
const fsPromise = fs.promises;
|
|
9
9
|
|
|
10
|
-
export default
|
|
10
|
+
export default function setupWebServer(
|
|
11
11
|
config = {
|
|
12
12
|
port: 1234,
|
|
13
13
|
debug: false,
|
|
@@ -16,8 +16,8 @@ export default async function setupWebServer(
|
|
|
16
16
|
},
|
|
17
17
|
cachedContent,
|
|
18
18
|
) {
|
|
19
|
-
|
|
20
|
-
|
|
19
|
+
const STATIC_FILES_PATH = path.join(config.projectRoot, config.output);
|
|
20
|
+
const server = new HTTPServer();
|
|
21
21
|
|
|
22
22
|
server.wss.on('connection', function connection(socket) {
|
|
23
23
|
socket.on('message', function message(data) {
|
|
@@ -42,9 +42,9 @@ export default async function setupWebServer(
|
|
|
42
42
|
});
|
|
43
43
|
});
|
|
44
44
|
|
|
45
|
-
server.get('/', async (
|
|
46
|
-
|
|
47
|
-
|
|
45
|
+
server.get('/', async (_req, res) => {
|
|
46
|
+
const TEST_RUNTIME_TO_INJECT = testRuntimeToInject(config.port, config);
|
|
47
|
+
const htmlContent = escapeAndInjectTestsToHTML(
|
|
48
48
|
replaceAssetPaths(
|
|
49
49
|
cachedContent.mainHTML.html,
|
|
50
50
|
cachedContent.mainHTML.filePath,
|
|
@@ -63,9 +63,9 @@ export default async function setupWebServer(
|
|
|
63
63
|
);
|
|
64
64
|
});
|
|
65
65
|
|
|
66
|
-
server.get('/qunitx.html', async (
|
|
67
|
-
|
|
68
|
-
|
|
66
|
+
server.get('/qunitx.html', async (_req, res) => {
|
|
67
|
+
const TEST_RUNTIME_TO_INJECT = testRuntimeToInject(config.port, config);
|
|
68
|
+
const htmlContent = escapeAndInjectTestsToHTML(
|
|
69
69
|
replaceAssetPaths(
|
|
70
70
|
cachedContent.mainHTML.html,
|
|
71
71
|
cachedContent.mainHTML.filePath,
|
|
@@ -85,10 +85,11 @@ export default async function setupWebServer(
|
|
|
85
85
|
});
|
|
86
86
|
|
|
87
87
|
server.get('/*', async (req, res) => {
|
|
88
|
-
|
|
88
|
+
const possibleDynamicHTML =
|
|
89
|
+
cachedContent.dynamicContentHTMLs[`${config.projectRoot}${req.path}`];
|
|
89
90
|
if (possibleDynamicHTML) {
|
|
90
|
-
|
|
91
|
-
|
|
91
|
+
const TEST_RUNTIME_TO_INJECT = testRuntimeToInject(config.port, config);
|
|
92
|
+
const htmlContent = escapeAndInjectTestsToHTML(
|
|
92
93
|
possibleDynamicHTML,
|
|
93
94
|
TEST_RUNTIME_TO_INJECT,
|
|
94
95
|
cachedContent.allTestCode,
|
|
@@ -103,12 +104,12 @@ export default async function setupWebServer(
|
|
|
103
104
|
);
|
|
104
105
|
}
|
|
105
106
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
107
|
+
const url = req.url;
|
|
108
|
+
const requestStartedAt = new Date();
|
|
109
|
+
const filePath = (
|
|
109
110
|
url.endsWith('/') ? [STATIC_FILES_PATH, url, 'index.html'] : [STATIC_FILES_PATH, url]
|
|
110
111
|
).join('');
|
|
111
|
-
|
|
112
|
+
const statusCode = (await pathExists(filePath)) ? 200 : 404;
|
|
112
113
|
|
|
113
114
|
res.writeHead(statusCode, {
|
|
114
115
|
'Content-Type': req.headers.accept?.includes('text/html')
|
|
@@ -129,11 +130,11 @@ export default async function setupWebServer(
|
|
|
129
130
|
}
|
|
130
131
|
|
|
131
132
|
function replaceAssetPaths(html, htmlPath, projectRoot) {
|
|
132
|
-
|
|
133
|
-
|
|
133
|
+
const assetPaths = findInternalAssetsFromHTML(html);
|
|
134
|
+
const htmlDirectory = htmlPath.split('/').slice(0, -1).join('/');
|
|
134
135
|
|
|
135
136
|
return assetPaths.reduce((result, assetPath) => {
|
|
136
|
-
|
|
137
|
+
const normalizedFullAbsolutePath = path.normalize(`${htmlDirectory}/${assetPath}`);
|
|
137
138
|
|
|
138
139
|
return result.replace(assetPath, normalizedFullAbsolutePath.replace(projectRoot, '.'));
|
|
139
140
|
}, html);
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import fs from 'node:fs/promises';
|
|
2
2
|
|
|
3
3
|
export default async function writeOutputStaticFiles({ projectRoot, output }, cachedContent) {
|
|
4
|
-
|
|
5
|
-
|
|
4
|
+
const staticHTMLPromises = Object.keys(cachedContent.staticHTMLs).map(async (staticHTMLKey) => {
|
|
5
|
+
const htmlRelativePath = staticHTMLKey.replace(`${projectRoot}/`, '');
|
|
6
6
|
|
|
7
7
|
await ensureFolderExists(`${projectRoot}/${output}/${htmlRelativePath}`);
|
|
8
8
|
await fs.writeFile(
|
|
@@ -10,8 +10,8 @@ export default async function writeOutputStaticFiles({ projectRoot, output }, ca
|
|
|
10
10
|
cachedContent.staticHTMLs[staticHTMLKey],
|
|
11
11
|
);
|
|
12
12
|
});
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
const assetPromises = Array.from(cachedContent.assets).map(async (assetAbsolutePath) => {
|
|
14
|
+
const assetRelativePath = assetAbsolutePath.replace(`${projectRoot}/`, '');
|
|
15
15
|
|
|
16
16
|
await ensureFolderExists(`${projectRoot}/${output}/${assetRelativePath}`);
|
|
17
17
|
await fs.copyFile(assetAbsolutePath, `${projectRoot}/${output}/${assetRelativePath}`);
|
|
@@ -22,7 +22,7 @@ export default function (COUNTER, details) {
|
|
|
22
22
|
details.assertions.reduce((errorCount, assertion, index) => {
|
|
23
23
|
if (!assertion.passed && assertion.todo === false) {
|
|
24
24
|
COUNTER.errorCount++;
|
|
25
|
-
|
|
25
|
+
const stack = assertion.stack?.match(/\(.+\)/g);
|
|
26
26
|
|
|
27
27
|
console.log(' ---');
|
|
28
28
|
console.log(
|
|
@@ -59,7 +59,7 @@ export default function (COUNTER, details) {
|
|
|
59
59
|
|
|
60
60
|
function getCircularReplacer() {
|
|
61
61
|
const ancestors = [];
|
|
62
|
-
return function (
|
|
62
|
+
return function (_key, value) {
|
|
63
63
|
if (typeof value !== 'object' || value === null) {
|
|
64
64
|
return value;
|
|
65
65
|
}
|
package/lib/utils/find-chrome.js
CHANGED
|
@@ -2,8 +2,8 @@ import { exec } from 'node:child_process';
|
|
|
2
2
|
|
|
3
3
|
const CANDIDATES = ['google-chrome-stable', 'google-chrome', 'chromium', 'chromium-browser'];
|
|
4
4
|
|
|
5
|
-
export default
|
|
6
|
-
if (process.env.CHROME_BIN) return process.env.CHROME_BIN;
|
|
5
|
+
export default function findChrome() {
|
|
6
|
+
if (process.env.CHROME_BIN) return Promise.resolve(process.env.CHROME_BIN);
|
|
7
7
|
|
|
8
8
|
return Promise.any(
|
|
9
9
|
CANDIDATES.map(
|
|
@@ -3,13 +3,13 @@ import searchInParentDirectories from './search-in-parent-directories.js';
|
|
|
3
3
|
|
|
4
4
|
export default async function () {
|
|
5
5
|
try {
|
|
6
|
-
|
|
6
|
+
const absolutePath = await searchInParentDirectories('.', 'package.json');
|
|
7
7
|
if (!absolutePath.includes('package.json')) {
|
|
8
8
|
throw new Error('package.json mising');
|
|
9
9
|
}
|
|
10
10
|
|
|
11
11
|
return absolutePath.replace('/package.json', '');
|
|
12
|
-
} catch (
|
|
12
|
+
} catch (_error) {
|
|
13
13
|
console.log('couldnt find projects package.json, did you run $ npm init ??');
|
|
14
14
|
process.exit(1);
|
|
15
15
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import process from 'node:process';
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
const stdin = process.stdin;
|
|
4
|
+
const targetInputs = {};
|
|
5
|
+
const inputs = [];
|
|
6
6
|
let listenerAdded = false;
|
|
7
7
|
|
|
8
8
|
export default function listenToKeyboardKey(
|
|
@@ -22,10 +22,10 @@ export default function listenToKeyboardKey(
|
|
|
22
22
|
inputs.shift();
|
|
23
23
|
inputs.push(key);
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
if (targetListener && targetListenerConformsToCase(targetListener,
|
|
28
|
-
targetListener.closure(
|
|
25
|
+
const currentInput = inputs.join('');
|
|
26
|
+
const targetListener = targetInputs[currentInput.toUpperCase()];
|
|
27
|
+
if (targetListener && targetListenerConformsToCase(targetListener, currentInput)) {
|
|
28
|
+
targetListener.closure(currentInput);
|
|
29
29
|
inputs.fill(undefined);
|
|
30
30
|
}
|
|
31
31
|
});
|
|
@@ -6,15 +6,13 @@ export default async function resolvePortNumberFor(portNumber) {
|
|
|
6
6
|
return await resolvePortNumberFor(portNumber + 1);
|
|
7
7
|
}
|
|
8
8
|
|
|
9
|
-
function portIsAvailable(portNumber) {
|
|
10
|
-
|
|
11
|
-
|
|
9
|
+
async function portIsAvailable(portNumber) {
|
|
10
|
+
const net = await import('net');
|
|
11
|
+
return new Promise((resolve) => {
|
|
12
12
|
const server = net.createServer();
|
|
13
13
|
|
|
14
|
-
server.once('error', function (
|
|
15
|
-
|
|
16
|
-
resolve(false);
|
|
17
|
-
}
|
|
14
|
+
server.once('error', function (_err) {
|
|
15
|
+
resolve(false);
|
|
18
16
|
});
|
|
19
17
|
|
|
20
18
|
server.once('listening', function () {
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
import pathExists from './path-exists.js';
|
|
2
2
|
|
|
3
3
|
async function searchInParentDirectories(directory, targetEntry) {
|
|
4
|
-
|
|
4
|
+
const resolvedDirectory = directory === '.' ? process.cwd() : directory;
|
|
5
5
|
|
|
6
|
-
if (await pathExists(`${
|
|
7
|
-
return `${
|
|
8
|
-
} else if (
|
|
6
|
+
if (await pathExists(`${resolvedDirectory}/${targetEntry}`)) {
|
|
7
|
+
return `${resolvedDirectory}/${targetEntry}`;
|
|
8
|
+
} else if (resolvedDirectory === '') {
|
|
9
9
|
return;
|
|
10
10
|
}
|
|
11
11
|
|
|
12
12
|
return await searchInParentDirectories(
|
|
13
|
-
|
|
13
|
+
resolvedDirectory.slice(0, resolvedDirectory.lastIndexOf('/')),
|
|
14
14
|
targetEntry,
|
|
15
15
|
);
|
|
16
16
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "qunitx-cli",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.2",
|
|
5
5
|
"description": "Browser runner for QUnitx: run your qunitx tests in google-chrome",
|
|
6
6
|
"main": "cli.js",
|
|
7
7
|
"author": "Izel Nakri",
|
|
@@ -16,14 +16,15 @@
|
|
|
16
16
|
],
|
|
17
17
|
"scripts": {
|
|
18
18
|
"bin": "chmod +x cli.js && ./cli.js",
|
|
19
|
-
"
|
|
20
|
-
"
|
|
19
|
+
"format": "prettier --check \"lib/**/*.js\" \"test/**/*.js\" \"*.js\" \"package.json\" \".github/**/*.yml\"",
|
|
20
|
+
"format:fix": "prettier --write \"lib/**/*.js\" \"test/**/*.js\" \"*.js\" \"package.json\" \".github/**/*.yml\"",
|
|
21
|
+
"lint": "deno lint lib/ cli.js",
|
|
21
22
|
"build": "node build.js",
|
|
22
23
|
"changelog:unreleased": "git-cliff --unreleased --strip all",
|
|
23
24
|
"changelog:preview": "git-cliff",
|
|
24
25
|
"changelog:update": "git-cliff --output CHANGELOG.md",
|
|
25
26
|
"prepack": "npm run build",
|
|
26
|
-
"test": "node test/setup.js && node --test test/**/*-test.js",
|
|
27
|
+
"test": "node test/setup.js && FORCE_COLOR=0 node --test test/**/*-test.js",
|
|
27
28
|
"test:sanity-first": "./cli.js test/helpers/failing-tests.js test/helpers/failing-tests.ts",
|
|
28
29
|
"test:sanity-second": "./cli.js test/helpers/passing-tests.js test/helpers/passing-tests.ts"
|
|
29
30
|
},
|
|
@@ -53,7 +54,7 @@
|
|
|
53
54
|
"express": "^5.2.1",
|
|
54
55
|
"prettier": "^3.8.1",
|
|
55
56
|
"qunit": "^2.25.0",
|
|
56
|
-
"qunitx": "^0.
|
|
57
|
+
"qunitx": "^1.0.0"
|
|
57
58
|
},
|
|
58
59
|
"volta": {
|
|
59
60
|
"node": "24.14.0"
|