@lvce-editor/test-with-playwright 21.0.0 → 22.1.0

package/README.md

@@ -33,6 +33,8 @@ test('sample.hello-world', async () => {
 - `--server-path`: explicit server entry point
 - `--filter`: run only matching tests
 - `--headless`: run Playwright in headless mode
+- `--reuse-page`: run browser tests through `/tests/_all.html` on one page
+- `--timeout`: test timeout in milliseconds, defaults to `30000` or `600000` with `--reuse-page`
 - `--browser`: browser engine to launch: `chromium`, `firefox`, or `webkit`
 - `--trace-focus`: add `traceFocus=true` to test URLs
 - `--electron-path`: path to an existing Electron app executable
@@ -44,9 +46,28 @@ test('sample.hello-world', async () => {
 ## Runtime Notes
 
 - `browser` keeps the server-backed HTML test execution flow.
+- `--reuse-page` is browser-only. It loads `/tests/_all.html` once and reads JSON results from a hidden `.TestResults` element.
 - `electron` downloads or reuses a Lvce Electron app, launches it with Playwright, and runs each test module against the first window.
 - `--electron-path` skips downloading and is useful for custom local builds.
 
+## Reuse Page Results
+
+When `--reuse-page` is enabled, `/tests/_all.html` should run the tests and write a JSON array into `.TestResults`:
+
+```json
+[
+  {
+    "name": "sample.hello-world.js",
+    "status": "pass",
+    "error": "",
+    "start": 0,
+    "end": 12.5
+  }
+]
+```
+
+`status` must be `pass`, `skip`, or `fail`. `error` is optional and defaults to an empty string.
+
 ## Environment Variables
 
 - `ONLY_EXTENSION`

package/dist/main.js

@@ -124,9 +124,11 @@ Options:
   --runtime=<runtime>       Runtime to run tests in: browser or electron
   --filter=<pattern>        Only run tests matching the filter
   --headless                Run the browser in headless mode
+  --reuse-page              Run browser tests through /tests/_all.html on one page
   --only-extension=<path>   Path to the extension under test
   --server-path=<path>      Path to the editor server entrypoint
   --test-path=<path>        Path to the test files
+  --timeout=<ms>            Test timeout in milliseconds
   --trace-focus             Log focus changes while tests run
   --electron-path=<path>    Path to an existing Electron app executable
   --electron-version=<ver>  Lvce release version to download, for example v0.84.0
@@ -395,6 +397,18 @@ const toStringArray = value => {
   }
   return [toCliString(value)];
 };
+const toPositiveNumber = (value, name) => {
+  const number = Number(toCliString(value));
+  if (!Number.isFinite(number) || number <= 0) {
+    throw new TypeError(`expected ${name} to be a positive number`);
+  }
+  return number;
+};
+const setOptionalPositiveNumber = (result, key, value, name) => {
+  if (value !== undefined) {
+    result[key] = toPositiveNumber(value, name);
+  }
+};
 const parseCliArgs = argv => {
   const parsed = parseArgv(argv);
   const result = Object.create(null);
@@ -416,9 +430,13 @@ const parseCliArgs = argv => {
   if (parsed['only-extension']) {
     result.onlyExtension = String(parsed['only-extension']);
   }
+  if (parsed['reuse-page']) {
+    result.reusePage = true;
+  }
   if (parsed['test-path']) {
     result.testPath = String(parsed['test-path']);
   }
+  setOptionalPositiveNumber(result, 'timeout', parsed.timeout, '--timeout');
   if (parsed['server-path']) {
     result.serverPath = String(parsed['server-path']);
   }
@@ -457,13 +475,17 @@ const parseEnv = env => {
 };
 
 const browsers = ['chromium', 'firefox', 'webkit'];
+const defaultTimeout = 30_000;
+const reusePageDefaultTimeout = 600_000;
 const defaultOptions = {
   browser: 'chromium',
   extensionPath: '',
   headless: false,
   help: false,
+  reusePage: false,
   runtime: 'browser',
-  testPath: ''
+  testPath: '',
+  timeout: defaultTimeout
 };
 const isBrowser = value => {
   return browsers.includes(value);
@@ -485,12 +507,19 @@ const getOptions = ({
   }
   const browser = parsedArgs.browser ?? defaultOptions.browser;
   const runtime = parsedArgs.runtime ?? defaultOptions.runtime;
+  if (parsedArgs.reusePage && runtime === 'electron') {
+    throw new Error('[test-with-playwright] --reuse-page is only supported with --runtime=browser');
+  }
+  const reusePage = parsedArgs.reusePage ?? defaultOptions.reusePage;
+  const timeout = parsedArgs.timeout ?? (reusePage ? reusePageDefaultTimeout : defaultTimeout);
   return {
     ...defaultOptions,
     ...parsedEnv,
     ...parsedArgs,
     browser,
-    runtime
+    reusePage,
+    runtime,
+    timeout
   };
 };
 
@@ -1789,6 +1818,7 @@ const runAllTests = async ({
   filter,
   headless,
   onlyExtension,
+  reusePage,
   runtimeOptions,
   testPath,
   testWorkerUri,
@@ -1803,7 +1833,7 @@ const runAllTests = async ({
     path,
     stdio: 'inherit'
   });
-  await rpc.invoke(RunAllTests, onlyExtension, testPath, cwd, browser, headless, timeout, runtimeOptions, traceFocus, filter);
+  await rpc.invoke(RunAllTests, onlyExtension, testPath, cwd, browser, headless, timeout, runtimeOptions, traceFocus, filter, reusePage);
   await rpc.dispose();
 };
 
@@ -1828,16 +1858,17 @@ const handleCliArgs = async ({
     headless,
     help,
     onlyExtension,
+    reusePage,
     runtime,
     serverPath,
     testPath,
+    timeout,
     traceFocus
   } = options;
   if (help) {
     console.info(getHelpMessage());
     return;
   }
-  const timeout = 30_000;
   const testWorkerUri = getTestWorkerUrl();
   const runtimeOptions = await getRuntimeOptions({
     cwd,
@@ -1869,6 +1900,7 @@ const handleCliArgs = async ({
     headless,
     // @ts-ignore
     onlyExtension,
+    reusePage,
     runtimeOptions,
     testPath,
     testWorkerUri,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lvce-editor/test-with-playwright",
-  "version": "21.0.0",
+  "version": "22.1.0",
   "description": "CLI tool for running Playwright tests",
   "repository": {
     "type": "git",
@@ -12,8 +12,8 @@
   "main": "dist/main.js",
   "bin": "bin/test-with-playwright.js",
   "dependencies": {
-    "@lvce-editor/test-with-playwright-worker": "21.0.0",
-    "@lvce-editor/test-worker": "^16.4.0"
+    "@lvce-editor/test-with-playwright-worker": "22.1.0",
+    "@lvce-editor/test-worker": "^16.5.0"
   },
   "engines": {
     "node": ">=24"