qunitx-cli 0.8.0 → 0.9.0

package/README.md

@@ -7,13 +7,14 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 Browser-based test runner for [QUnitX](https://github.com/izelnakri/qunitx) — bundles your JS/TS tests
-with esbuild, runs them in headless Chrome, and streams TAP output to the terminal.
+with esbuild, runs them in a headless browser via [Playwright](https://playwright.dev), and streams TAP
+output to the terminal.
 
 ![qunitx-cli demo](docs/demo.gif)
 
 ## Features
 
-- Runs `.js` and `.ts` test files in headless Chrome (Puppeteer + esbuild)
+- Runs `.js` and `.ts` test files in headless Chrome, Firefox, or WebKit (Playwright + esbuild)
 - TypeScript works with zero configuration — esbuild handles transpilation
 - Inline source maps for accurate stack traces pointing to original source files
 - Streams TAP-formatted output to the terminal in real time
@@ -23,6 +24,7 @@ with esbuild, runs them in headless Chrome, and streams TAP output to the termin
 - `--debug` prints the local server URL and pipes browser console to stdout
 - `--before` / `--after` hook scripts for server setup and teardown
 - `--timeout` controls the maximum ms to wait for the full suite to finish
+- `--browser` flag to run tests in Chromium, Firefox, or WebKit
 - Docker image for zero-install CI usage
 
 ## Installation
@@ -69,7 +71,7 @@ qunitx test/**/*.js --watch
 # Stop on the first failure
 qunitx test/**/*.js --failFast
 
-# Print the server URL and pipe Chrome console to stdout
+# Print the server URL and pipe browser console to stdout
 qunitx test/**/*.js --debug
 
 # Custom timeout (ms)
@@ -80,8 +82,18 @@ qunitx test/**/*.js --before=scripts/start-server.js
 
 # Run a teardown script after tests (can be async)
 qunitx test/**/*.js --after=scripts/stop-server.js
+
+# Run in Firefox or WebKit instead of Chromium
+qunitx test/**/*.js --browser=firefox
+qunitx test/**/*.js --browser=webkit
 ```
 
+> **Prerequisite for Firefox / WebKit:** install the Playwright browser binaries once:
+> ```sh
+> npx playwright install firefox
+> npx playwright install webkit
+> ```
+
 ## Writing Tests
 
 qunitx-cli runs [QUnitX](https://github.com/izelnakri/qunitx) tests — a superset of QUnit with async
@@ -123,7 +135,7 @@ module('Basic sanity check', (hooks) => {
 Run it:
 
 ```sh
-# Headless Chrome (recommended for CI)
+# Headless Chromium (default, recommended for CI)
 qunitx some-test.js
 
 # With browser console output
@@ -145,7 +157,8 @@ All CLI flags can also be set in `package.json` under the `qunitx` key, so you d
     "output": "tmp",
     "timeout": 20000,
     "failFast": false,
-    "port": 1234
+    "port": 1234,
+    "browser": "chromium"
   }
 }
 ```
@@ -158,6 +171,7 @@ All CLI flags can also be set in `package.json` under the `qunitx` key, so you d
 | `timeout` | `20000` | Maximum milliseconds to wait for the full test suite before timing out. |
 | `failFast` | `false` | Stop the run after the first failing test. |
 | `port` | `1234` | Preferred HTTP server port. qunitx auto-selects a free port if this one is taken. |
+| `browser` | `"chromium"` | Browser engine to use: `"chromium"`, `"firefox"`, or `"webkit"`. Overridden by `--browser` on the CLI. |
 
 CLI flags always override `package.json` values when both are present.
 
@@ -176,16 +190,26 @@ Options:
   --before=<file>     Script to run (and optionally await) before tests start
   --after=<file>      Script to run (and optionally await) after tests finish
   --port=<n>          HTTP server port (auto-selects a free port if taken)
+  --browser=<name>    Browser engine: chromium (default), firefox, or webkit
 ```
 
 ## Development
 
 ```sh
 npm install
-make check                 # lint + test (run before every commit)
-make test                  # run tests only
-make demo                  # regenerate docs/demo.gif
-make release LEVEL=patch   # bump version, update changelog, tag, push
+make check                      # lint + test (run before every commit)
+make test                       # run full test suite (Chromium)
+make test-firefox               # run browser tests with Firefox
+make test-webkit                # run browser tests with WebKit
+make test-all-browsers          # run full suite on all three browsers
+make demo                       # regenerate docs/demo.gif
+make release LEVEL=patch        # bump version, update changelog, tag, push
+```
+
+Use `--trace-perf` to print internal timing to stderr — useful when investigating startup or e2e regressions:
+
+```sh
+qunitx test/my-test.js --trace-perf
 ```
 
 ## License

package/cli.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import process from 'node:process';
+import './lib/utils/early-chrome.js';
 import displayHelpOutput from './lib/commands/help.js';
 import initializeProject from './lib/commands/init.js';
 import generateTestFiles from './lib/commands/generate.js';
-import run from './lib/commands/run.js';
 import setupConfig from './lib/setup/config.js';
 
 process.title = 'qunitx';
@@ -19,7 +19,13 @@ process.title = 'qunitx';
     return await initializeProject();
   }
 
-  const config = await setupConfig();
+  // Lazy import: run.js (and its static imports like esbuild and playwright-core) are
+  // only loaded when actually running tests. Importing in parallel with setupConfig()
+  // lets playwright-core start loading while config is being assembled.
+  const [config, { default: run }] = await Promise.all([
+    setupConfig(),
+    import('./lib/commands/run.js'),
+  ]);
 
   return await run(config);
 })();

package/deno.json

@@ -1,14 +1,8 @@
 {
   "nodeModulesDir": "auto",
   "imports": {
-    "cheerio": "npm:cheerio",
-    "chokidar": "npm:chokidar",
     "esbuild": "npm:esbuild",
-    "js-yaml": "npm:js-yaml",
-    "kleur": "npm:kleur",
     "picomatch": "npm:picomatch",
-    "puppeteer": "npm:puppeteer",
-    "recursive-lookup": "npm:recursive-lookup",
     "ws": "npm:ws"
   },
   "tasks": {