@unotest/web 0.50.0 → 0.52.0
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/CHANGELOG.md +189 -3
- package/README.md +25 -0
- package/bin/unotest-web.js +2 -1
- package/dist/config/schema.d.ts +45 -18
- package/dist/config/schema.js +1 -1
- package/dist/driver/index.d.ts +11 -2
- package/dist/driver/index.js +1 -1
- package/dist/dsl/index.d.ts +389 -44
- package/dist/dsl/index.js +1 -1
- package/dist/dsl/v8/scenario-worker.d.ts +2 -0
- package/dist/dsl/v8/scenario-worker.js +1 -0
- package/dist/dsl/web-dsl-language-service.d.ts +6 -1
- package/dist/dsl/web-dsl-language-service.js +1 -1
- package/dist/inspection/page-inject.d.ts +34 -7
- package/dist/inspection/page-inject.js +69 -4
- package/dist/{interfaces--zgFOUB6.d.ts → interfaces-BSGmF_Tv.d.ts} +92 -3
- package/dist/{linter-Ci17V2Sr.d.ts → linter-CYRlmOLy.d.ts} +19 -0
- package/dist/mcp/server.js +1 -1
- package/dist/runner/cli.d.ts +1 -1
- package/dist/runner/cli.js +1 -1
- package/dist/runner/init/chrome-probe.js +1 -1
- package/dist/runner/init.js +1 -1
- package/dist/runner/install-chromium.js +1 -1
- package/dist/runner/prepare-fix.js +1 -1
- package/dist/runner/scaffold-workspace.js +1 -1
- package/dist/runner/serve-fixture.js +1 -1
- package/dist/runner/web-runner-adapter.js +1 -1
- package/guides/agent-integration.md +25 -2
- package/guides/dsl-reference.md +958 -228
- package/llms.txt +223 -0
- package/package.json +17 -8
- package/types/unotest-dsl.d.ts +328 -101
- package/types/unotest-lib.d.ts +93 -27
package/CHANGELOG.md
CHANGED
|
@@ -1,9 +1,195 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.52.0] - 2026-10-17
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 4e37bc3: BREAKING: scenarios run on V8, the engine of Node and Chrome, as the JavaScript they are. Classes, getters, generators, `Date`, `Symbol`, `instanceof` and the built-in objects now work, with the semantics of the language; the white list of the old library is gone. A scenario still has no APIs of Node or of the browser (`require`, `process`, `fetch`, `window`, timers): `apiCall`, `shell`, `evaluate`, `pause` and `waitUntil` stand in for them, and `console` prints nowhere. A scenario is not a sandbox: it runs with the rights of the user who started it, as a Playwright test does.
|
|
8
|
+
|
|
9
|
+
What changes for a suite, beyond the `let` and Continue entries of this release:
|
|
10
|
+
|
|
11
|
+
- `keys()`, `values()` and `entries()` of a Map or a Set, and `matchAll`, were arrays and are now iterators. `for…of` and a spread read them as before; an array method or a DSL function needs the spread first: `[...m.keys()].map(…)`.
|
|
12
|
+
- A test was also cut after a fixed count of statements (`maxSteps budget (100000) exhausted`). That count is gone: only the time budget (`setTestTimeout(ms)`, else `testTimeoutMs` or `UNOTEST_MAX_DURATION_MS`) cuts a test, and an endless loop fails on it, naming its line. A run that relied on the count to stop an endless loop sooner now runs until the time budget.
|
|
13
|
+
|
|
14
|
+
Migration: run `npx @unotest/web lint --fix`, commit the `let` lines it writes, then run the suite. Add the spread where a test reads keys, values or entries with an array method. The upgrade guide on docs.unotest.com lists every case.
|
|
15
|
+
|
|
16
|
+
- a5d8901: BREAKING: scenarios now run on the V8 engine only, as the JavaScript they are; the interpreter is gone from `@unotest/web`, and so is its export: `AstExecutor` is no longer exported from the package root. The `UNOTEST_ENGINE` switch is gone too; a value left set is ignored.
|
|
17
|
+
|
|
18
|
+
What a run reports changes where JavaScript says it differently: a name nothing declares fails as `ReferenceError: <name> is not defined` (`lint` still names it, with the advice for `wait` / `sleep` / `waitForTimeout`), and a member read on `null` or `undefined` fails with JavaScript's `TypeError`. An object handed to a DSL function with a key it only inherits, written under `__proto__:` or made by `Object.create(…)`, fails the step instead of being sent without that key. `arr.sortBy(…)` is gone with the interpreter's library: JavaScript's arrays have no such method.
|
|
19
|
+
|
|
20
|
+
Migration: drop `UNOTEST_ENGINE` from your environment. Replace `rows.sortBy('order')` with `rows.sort((a, b) => a.order - b.order)` (strings: `a.name.localeCompare(b.name)`; `{desc: true}`: swap `a` and `b`). A test rig that built `AstExecutor` runs scenarios through `npx @unotest/web e2e` or the MCP `run_test` tool instead.
|
|
21
|
+
|
|
22
|
+
- dd454ed: BREAKING: a variable assigned without a declaration (`i = 0` with no `let`) is now an error, `validator:implicit-global`: in JavaScript such a name is a global, shared by every test of the run. It was an info, `validator:implicit-declaration`. `run_test` refuses the scenario on it, as on any lint error; `e2e` prints it and runs. The diagnostic carries a fix — `let i;` at the start of the `test_*`, `flow_*` or helper, where every step sees the name — and `lint --fix` or `eslint --fix` with the plugin writes it.
|
|
23
|
+
|
|
24
|
+
The validator no longer refuses JavaScript the scenario language left out, nor members the old library lacked: `validator:out-of-language`, `validator:library-member` and `validator:unsupported-string-member` report nothing. A member a string, an array, a number, a Map or a Set does not have in JavaScript is `validator:unknown-member`, now checked against JavaScript itself, so `'a'.charCodeAt(0)` and `/a/.exec(s)` lint clean. A statement at the top level of a file is `validator:top-level-statement` (it was `validator:unsupported-statement`).
|
|
25
|
+
|
|
26
|
+
Migration: run `npx @unotest/web lint --fix` once and commit the `let` lines it adds. In `linter.rules`, rename `validator:unsupported-statement` to `validator:top-level-statement` and `validator:implicit-declaration` to `validator:implicit-global`, and drop `validator:out-of-language`, `validator:library-member` and `validator:unsupported-string-member`. A config that still names one of the five loads: the entry is ignored, and `lint` warns that it does nothing.
|
|
27
|
+
|
|
28
|
+
`@unotest/protocol`: `DslDiagnostic.fix` — `{range: [start, end], text}`, the edit that removes the finding, with 0-based offsets into the source. `@unotest/dsl`: `ScenarioDiagnostic.fix`, and `applyFixes(source, fixes)` from `@unotest/dsl/validator`.
|
|
29
|
+
|
|
30
|
+
- dd454ed: New: `npx @unotest/web lint` type-checks each scenario as the JavaScript it is — the file, the helpers of `_helpers/`, the DSL declarations and the external variable names. It reports, as warnings under `ts:<code>`, what the validator leaves to JavaScript: a name nothing declares, a member a value does not have (`Math.tau`), an argument of the wrong type (`n.toFixed('two')`). Where the validator reports at the same position, its line stands alone. The check needs `typescript` in the project (`npm i -D typescript`, an optional peer dependency); without it `lint` says once that the layer was skipped. And `lint --fix` writes the fixes the diagnostics offer before it reports. replaces: reading a scenario by eye for a typo of a name or a key
|
|
31
|
+
- 9159456: BREAKING: `async` and `await` in a scenario are a lint error, `validator:async-await`. Before, `await` was allowed in an `async function` and changed nothing. Now that scenarios run as JavaScript, an async function returns at its first `await`, and the rest of it runs after the test is over: its checks fail nowhere, and the test passes. DSL calls return their result, so a scenario has nothing to await. `run_test` and `e2e` refuse to start on it, and a run that gets there anyway fails: a test, a step, a rollback block, a `waitUntil` or an `assertNever` body that returns a promise fails the test with `… returned a promise: … drop async and await`. Async code handed to the page, `evaluate(async () => …)`, is the page's and is not reported.
|
|
32
|
+
|
|
33
|
+
Migration: run `npx @unotest/web lint --fix`. Each finding carries a fix that drops the word, so `lint --fix` and `eslint --fix` with the plugin remove every `async` and `await` the scenarios hold.
|
|
34
|
+
|
|
35
|
+
- 1946b74: BREAKING: Continue on a failure pause now finishes the test as failed. No statement after the failure runs; the `teardown(...)` blocks play and the failure bundle taken at the pause stays the run's. Before, the run went on with the next statement and still ended failed, so a debug run could pause again at a later failure. The CLI says it at the pause: `⏸ paused on failure at <file>:<line>:<col> — Continue finishes this test as failed`. The viewer now offers Continue on a failure pause, labelled **Finish as failed**; Step is not offered there. MCP `resume` on a `paused-failure` runtime ends it the same way. A failure pause the runner resumes as a retry (`resumeRetriesFailedStep`) is unchanged.
|
|
36
|
+
|
|
37
|
+
Migration: to see what follows a failure, fix the scenario and run the test again; a `resume` per failure no longer walks the test to its end.
|
|
38
|
+
|
|
39
|
+
- 5d9d6a4: Changed: `viewer` opens a browser tab only when a person is at the terminal — stdin and stdout are TTYs and `CI` is unset (or `0` / `false`). Launched by an agent, a script or CI, it prints the URL and opens nothing. `viewer --open` opens the tab anyway; `UNOTEST_VIEWER_NO_OPEN=1` still turns it off and beats `--open`. `login` follows the same rule, so under `CI` it no longer opens a browser even on a pseudo-terminal, and the commands that ask a question no longer ask it there: `init` uses the system browser when it finds one (as in a pipe), `box create` leaves the Picker off unless `--picker` is given, and `box destroy` needs `--yes`. `viewer` now refuses an argument it does not know (exit 2) instead of ignoring it.
|
|
40
|
+
|
|
41
|
+
### Patch Changes
|
|
42
|
+
|
|
43
|
+
- fa8d762: Fixed: `login` now also asks for `billing:read`, so `whoami` shows the balance on the documented path instead of "not visible to this key". The approval page still lets you untick it. A key from an earlier `login` keeps the permissions it was given: run `login` again (after `logout`) to get one that sees the balance.
|
|
44
|
+
- 82ca2ac: Changed: a test that never ends is cut by its time budget (`setTestTimeout(ms)`, else `testTimeoutMs`), not by a count of statements: the test fails naming the budget and the statement it was on, and its teardown blocks still play. Code that never returns to the runner, such as a regular expression that backtracks for minutes, is stopped a second after the budget, and its teardown blocks cannot play. A run that keeps too much in memory ends on a fixed memory limit, and the runner keeps going. `@unotest/dsl/executor` exports the budget readers a second engine shares with the interpreter: `durationBudget`, `timeLeft`, `withinDeadline`, `runHeapLimitBytes` and the `BudgetOptions` / `BudgetSite` types.
|
|
45
|
+
- 440bdcb: Changed: `@unotest/dsl/executor` exports what a second scenario engine needs to behave like the interpreter: the `waitUntil` and `assertNever` option readers and verdicts (`readWaitUntilOptions`, `waitUntilVerdict`, `readAssertNeverOptions`, `assertNeverVerdict`), a synchronous polling loop (`pollWindowSync`), `tagText`, `toExecutionError` and `softFailuresError`. A rollback frame is now `TeardownFrame<B>`, generic in what the engine that registered it plays it with (`ScenarioTeardownFrame` is `TeardownFrame<Closure>`); an engine handed a frame another engine registered refuses it with `ForeignTeardownFrameError`. Scenarios run exactly as before.
|
|
46
|
+
- be2f2dc: Changed: debugging works on V8 as it did before: breakpoints, Step, the viewer's Pause, the pause on a failure nobody catches, Vars while paused, and Stop on a pause.
|
|
47
|
+
- 843b58e: Changed: `@unotest/dsl` exports `pageCodeArgumentOf(call, pageCodeArg)`, the argument in a call's page-code position as written, and `@unotest/dsl/executor` exports the declaration readers the interpreter hoists with (`lexicalDeclarations`, `patternNames`, `hoistedVarNames`). Scenarios run exactly as before.
|
|
48
|
+
- 8655c26: Fixed: time a test spends held on a pause (a breakpoint, a Step, a failure being looked at) no longer counts toward its time budget (`setTestTimeout(ms)`, else `testTimeoutMs` or `UNOTEST_MAX_DURATION_MS`). After a long look at a breakpoint or a Step, Continue goes on with the budget the test had left when it stopped, instead of failing it with `budget exhausted` at the next line. On a failure pause, Continue finishes the test as failed.
|
|
49
|
+
- 423d119: Changed: `keys()`, `values()` and `entries()` of a Map or a Set, and `matchAll`, give iterators, as in JavaScript. `for…of`, a spread and `Array.from` read them; array methods need the spread first: `[...m.keys()].map(…)`. A DSL function given an iterator fails, naming the line and the spread to write; it takes `[...m.keys()]` or the Map itself. The editor typings say the same, and lint warns on an array method called on an iterator. `upload()` keeps its meaning wherever the scenario passes it: as the body of `apiCall` it is sent as multipart, nested in a JSON body it is refused as before.
|
|
50
|
+
- c307b42: Fixed: a scenario's environment no longer holds the runner's own credentials.
|
|
51
|
+
The cloud sign-in token, the box tokens and the judge's and grounder's
|
|
52
|
+
keys were already refused to `getVar`, `{{NAME}}` and `shell()`; a
|
|
53
|
+
scenario that reached `process.env` directly still saw them. The thread
|
|
54
|
+
a scenario runs on now starts without them, on the CLI and over MCP
|
|
55
|
+
alike. Variables a suite declares, or a CI job exports, read as before.
|
|
56
|
+
|
|
57
|
+
The docs now say plainly what this is: a guard against a slip, not a
|
|
58
|
+
sandbox. A scenario runs with the rights of the account that starts it.
|
|
59
|
+
|
|
60
|
+
- 223f143: Fixed: the viewer on a box starts again. Since 0.50.0 it created the breakpoint folder in the project at startup; a box mounts the project read-only, so the viewer exited and was restarted every few seconds, and the box showed "the viewer for this environment is not running".
|
|
61
|
+
|
|
62
|
+
The viewer now creates nothing at startup: the breakpoint folder appears with the first breakpoint. On a box the breakpoints live in the environment's run history, where both the viewer and the runs can write. Locally nothing changes: the store is still `.unotest/debugger.json`.
|
|
63
|
+
|
|
64
|
+
A breakpoint that cannot be saved because the folder is read-only is no longer lost silently: the viewer shows the reason above the steps.
|
|
65
|
+
|
|
66
|
+
`@unotest/protocol`: `localStateDirFrom(env, projectRoot)` names the directory of the tool's local state, and `debuggerFileNameFor(suffix)` the store's file name inside it. `@unotest/core`: `debuggerFileIn(stateDir, projectRoot, suffix)` takes that directory explicitly; `debuggerFile` and `readDebuggerBreakpoints` take an optional environment; `isNotWritable(error)` tells a read-only refusal apart.
|
|
67
|
+
|
|
68
|
+
- Updated dependencies [82ca2ac]
|
|
69
|
+
- Updated dependencies [440bdcb]
|
|
70
|
+
- Updated dependencies [dd454ed]
|
|
71
|
+
- Updated dependencies [843b58e]
|
|
72
|
+
- Updated dependencies [9159456]
|
|
73
|
+
- Updated dependencies [1946b74]
|
|
74
|
+
- Updated dependencies [423d119]
|
|
75
|
+
- Updated dependencies [223f143]
|
|
76
|
+
- @unotest/dsl@0.52.0
|
|
77
|
+
- @unotest/protocol@0.52.0
|
|
78
|
+
- @unotest/viewer@0.52.0
|
|
79
|
+
- @unotest/core@0.52.0
|
|
80
|
+
- @unotest/grounder-client@0.52.0
|
|
81
|
+
|
|
82
|
+
## [0.51.0] - 2026-10-15
|
|
83
|
+
|
|
84
|
+
### Minor Changes
|
|
85
|
+
|
|
86
|
+
- c9dfb29: New: `animations(getByTestId('status'))` returns every animation of the element and its descendants as `[{name, kind, playState, currentTime?, infinite}]`, the typed read of what is moving and how. replaces: evaluateOnLocator with getAnimations. `name` is the keyframes name, the property a transition moves, or a script animation's id. Infinite and paused animations are listed too, marked by `infinite` and `playState`; `hasAnimation` and `waitForAnimations` count only the running ones that end by themselves, as before.
|
|
87
|
+
- 7ffd47b: New: `npx @unotest/web api [word...]` finds the DSL function for what you mean. replaces: searching the reference by a name you do not know yet. It prints one line per function: signature, the keys its options take, the release that added it, and when you need it. Search by the habit you know: `api wait animation` gives waitForAnimations, `api not appear` gives assertNeverAppears, `api sleep` gives pause; every word must match the name, a synonym or the description. Without a word it lists every function by section. The same index ships as `llms.txt` at the package root and as the first screen of the README, "What unotest can do".
|
|
88
|
+
- 81a97d6: New: `apiCall('POST', '/live/start', body, null, {timeoutMs: 150000})` gives one call a budget of its own, the reply body included. replaces: nothing (a call waited as long as the step and the test allowed, and `{timeout}` was refused). Past the budget the request is aborted and the step fails as a timeout naming the call by method and path, without the base or the query. Without `{timeoutMs}` a call behaves as before. It combines with `{base}` in the same options object.
|
|
89
|
+
- 17f4bc2: New: `assertFileLacks('logs', API_TOKEN)` and `assertFileHas('tmp/dump.sql', /v1:[A-Za-z0-9+\/=]{20,}/)` check that a string or a regex is absent from, or present in, a file or a whole directory tree. replaces: shell with grep after the run, outside the report. A string is searched as bytes, so binary files count; a regex reads files as UTF-8. `assertFileHas` waits up to `{timeoutMs}` (default 20 s). `assertFileLacks` searches once, or watches `{withinMs}`, and a path that does not exist fails rather than passes. A hit names the file and the line, with the matched bytes replaced by `‹match, N bytes›`, so a regex that catches an unregistered secret does not copy it into the report. Paths follow the same rules as `readFile`; symlinks inside a directory are not followed.
|
|
90
|
+
- 6ea4085: New: `assertNever(() => apiCall('GET', '/me').status == 200, {withinMs: 5000})`, a negative window for a condition, the pair of `assertNeverAppears` for anything that is not a locator. replaces: pause. The body (an expression, or a block that `return`s its value) is polled for the whole window; the step fails the moment it is truthy, naming the value and the time into the window, and passes when the window elapsed clean. `pause(ms)` followed by one assertion misses an event that came and went during the pause. `withinMs` is required, `intervalMs` defaults to 250. A malformed call is reported under the new validator rule `validator:assert-never-shape`. A suite function of its own named `assertNever` keeps running as before.
|
|
91
|
+
- 45dbd8b: New: `assertClipboard(/\/invite\/\d+$/)` waits until the clipboard holds the text a "copy" button wrote, and `clipboardRead()` returns that text. replaces: evaluate replacing navigator.clipboard.writeText in the page. A string is the whole text, a regex a match; `{timeoutMs}` defaults to 5 s. Works in Chromium and Firefox on an https or localhost page. WebKit does not let a page read the clipboard, and the call fails naming the engine instead of returning an empty string. In Chromium every new browser context now has clipboard read and write access, so a page's own copy button succeeds in a headless run, as it does for a person in desktop Chrome. The clipboard belongs to the browser, so tests running in parallel in one browser share it.
|
|
92
|
+
- ac8f70a: BREAKING: a DSL call now checks, when it runs, the kind of every argument lint could not see: a variable, a field of an API reply, a value built in a loop. One of another kind stops the step on its line with the sentence lint shows for a literal: `fill(): argument 2 (text) must be a string value, got number 42`, `click(): option timeoutMs must be a number, got a string "5000"`. Before, some functions refused such a value in words of their own and some coerced it: `getByText('Total', {exact: e})` with `e` holding the string `"no"` matched exactly and failed seconds later as `locator not visible within timeout`. A condition is still read by truthiness, so only a number, a string or a locator passed as one is refused. Where a client's suite relied on a coercion, the call still runs with a warning ending in `an error from 0.52.0`.
|
|
93
|
+
|
|
94
|
+
Migration: convert the value where it is made, `String(total)` for text, `Number(env('WAIT_MS'))` for a time limit, a comparison for a condition. Run the suite once and fix every line the run stops on or warns about.
|
|
95
|
+
|
|
96
|
+
Changed: lint now checks `setViewport` and `emulateMedia` arguments before the run, as the run already did: a misspelt key (`{heigth}`), a value `emulateMedia` does not take (`{colorScheme: 'blue'}`) or anything but a size or `null` for `setViewport` is named on its line. The editor types follow: `setViewport(size: {width, height} | null)`, and `emulateMedia` offers its values.
|
|
97
|
+
|
|
98
|
+
Signatures, the API index (`npx @unotest/web api`, `llms.txt`) and the DSL reference now name the time limit `timeoutMs`, the key the option lists and refusals already used. `timeout` still works as an alias; the index marks it once per function: `options {state?, timeoutMs?} (alias: timeout → timeoutMs)`. Signatures that missed keys their function takes now list them (`waitUntil` on goBack, goForward and waitForUrl; `force` on selectOption; `position` and `modifiers` on doubleClick), and `waitForText` no longer offers `first`, which has been refused since 0.50.0.
|
|
99
|
+
|
|
100
|
+
The DSL reference has a Signatures section: every function with the types it takes, generated from the same contract lint and the run check against, so it cannot drift from them.
|
|
101
|
+
|
|
102
|
+
Changed: `waitUntil` (goto, reload, goBack, goForward, waitForUrl) takes `'load'`, `'domcontentloaded'`, `'networkidle'` or `'commit'`, and lint and the run name a misspelt one on its line: `goto(): option waitUntil must be one of: load, domcontentloaded, networkidle, commit`. Before, it reached the browser, which failed the step with its own message. The reference now lists `'commit'` and the editor offers the four values.
|
|
103
|
+
|
|
104
|
+
`@unotest/dsl`: the argument kind `'null'`, for a slot that takes `null` as one member of a `{oneOf}`; `hint` on an argument, a sentence lint and the run append to a refused value (`round(): argument 1 (n) must be a number, got a string "2.5" — read text with toNumber(text) first`), and option notes appended the same way to a key's refused value; `canonicalOptionKeys`, the keys of an options schema without their aliases.
|
|
105
|
+
|
|
106
|
+
- 1c16eba: New: a `collection` run says how long it took. The summary line ends with the wall clock of the whole run, every worker at once — `collection regress: failed — pass=21, fail=1, time=252.3s` — and each test of a file of several gets its own time beside its name, as the file's line already had: `✓ test_checkout (812ms)`. replaces: wrapping the run in `time` and adding up the per-file lines. The collection's journal carries the same total on its last line (`durationMs`), and each test's time in the file's entry, for whatever reads the run afterwards.
|
|
107
|
+
- 809c738: New: MCP tool `dsl_lookup({task: 'wait until the dialog stops animating'})` answers "how do I" in plain words with the 1-3 DSL functions for it, best first: signature, option keys, the release that added it, one example line and where the shipped guide describes it. replaces: guessing a function name, or writing pause, page code or shell for a step the language already has. Words no function holds return none and a hint. It is part of the core toolset too. The answers come from the same index as `npx @unotest/web api`, which now also matches a longer form of a word (`animating` finds waitForAnimations).
|
|
108
|
+
- cb1161b: New: `lint:external-variable-no-value` reports a variable that only `unotest/.env.example` or `.secrets.example` declares while no file, overlay or the shell gives it a value. replaces: `lint:external-variable-undeclared` for that case, whose text sent the author to add a name that was already declared. The message names the template and where to set the value: `unotest/.env`, the active overlay, or the shell. A run reports it (`run_test`, the pre-run check of `e2e`); the `lint` command reads files alone and counts a template name as declared, so a value a CI runner exports does not turn it red. `lint:external-variable-undeclared` now means a name no file declares at all.
|
|
109
|
+
|
|
110
|
+
Fixed: the run header lists only the files values come from, in order, and names `.env.example` / `.secrets.example` apart as `declared names only`; a placeholder value in a template never reaches the run.
|
|
111
|
+
|
|
112
|
+
- 8b70693: New: config key `profile: "ios"` runs the suite in WebKit as an iPhone (the `"iPhone 15"` preset: size, scale, touch, mobile mode, user agent) launched from the home screen, in one line; `browsers` or `device` next to it is refused. replaces: `browsers: ["webkit"]` with `device` and a page-side `navigator.standalone` stub. Config key `displayMode: 'browser' | 'standalone' | 'minimal-ui' | 'fullscreen'` sets the launch mode the page's scripts see from the first document on: `matchMedia('(display-mode: standalone)')` answers for it, and in WebKit `navigator.standalone` is `true`. No engine emulates the feature itself, so CSS `@media (display-mode: …)` still sees a browser tab. Playwright WebKit is not Safari on iOS: no zoom on focus, no on-screen keyboard.
|
|
113
|
+
- 7630fbf: New: linter rule `lint:typed-step-available` (info) names the typed step for code a scenario wrote by hand, e.g. `pause(5000); assertHidden(getByText('Error'))` → `assertNeverAppears(getByText('Error'), {withinMs: 5000})`. replaces: pause before an absence check, pause to let an animation settle, evaluate with getComputedStyle, evaluate with naturalWidth.
|
|
114
|
+
|
|
115
|
+
It reports `getComputedStyle` in page code (use `computedStyle(locator, property)`), `naturalWidth` / `complete` (use `getImageSize(locator)`), a `pause` before `assertHidden` or `assertCount(…, 0)` (use `assertNeverAppears(locator, {withinMs})`), and a `pause` whose step label or comment mentions a fade, an animation or a control being enabled (use `waitForAnimations(locator)` or `waitFor(locator, {state: 'enabled'})`). Each message names the section of `node_modules/@unotest/web/guides/dsl-reference.md` that describes the step. Set the rule to `off` in `linter.rules` to silence it.
|
|
116
|
+
|
|
117
|
+
- 099b79f: New: MCP client steps — a scenario starts a stdio MCP server, calls its tools and waits for its notifications: `const srv = mcpStart('node', ['server.js']); mcpCall(srv, 'echo', {text: 'hi'}); mcpWaitNotification(srv, 'notifications/message', {match: {'data.echoed': 'hi'}})`. Every call, result and notification is a note in the run's report; a failing step (JSON-RPC error, timeout, a result marked `isError` unless `{allowError: true}`, the server exiting) quotes the server's last MCP message, so the failure bundle shows it. `mcpStop(srv)` is optional: a server the test leaves running is stopped when the test ends, passed or failed. `env` passed to `mcpStart` is named in the report, never its values. replaces: bun scripts next to the suite.
|
|
118
|
+
- 355f512: BREAKING: page code given to `evaluate`, `evaluateOnLocator` or `evaluateInServiceWorker` as a string is now parsed by the validator. A string that is not one JavaScript expression is refused before the run as `validator:page-code-syntax`, with the line and column inside the string, e.g. `evaluateOnLocator(locator('body'), '(b) => b.querySelectorAll("li").')`. Such a step used to fail only when the run reached it.
|
|
119
|
+
|
|
120
|
+
A string that parses gets an info, `validator:page-code-string`, with the rewrite to a function literal: a function in quotes loses the quotes, an expression becomes `() => …`. A function literal is checked with the file. Text built with `+` or held in a variable is not parsed.
|
|
121
|
+
|
|
122
|
+
Migration: fix the syntax the message points at, or write the page code as a function literal: `evaluateOnLocator(loc, (el) => el.textContent)`. A regular expression inside a backtick template is a common case: `\/` there reads as `/`, so `` `… /^a\/(b)/ …` `` reaches the page as an unterminated group — the step failed at run time already, now it is named before the run. Write `\\/` or use `` String.raw`…` ``. Set `validator:page-code-string` to `off` in `linter.rules` to silence the info.
|
|
123
|
+
|
|
124
|
+
- 10551d7: New: `setPageHidden(hidden, index?)` sends a tab to the background as the page's scripts see it, and brings it back. `setPageHidden(true)` makes `document.hidden` true and `visibilityState` `'hidden'`, `document.hasFocus()` false, and fires `blur` then `visibilitychange`; `setPageHidden(false)` fires `visibilitychange` then `focus`. The state holds across navigations and in frames until the tab is shown again. replaces: overriding `document.hidden` by hand in `evaluate`, or handing the check to a person.
|
|
125
|
+
|
|
126
|
+
It emulates visibility for the page's scripts in Chromium, Firefox and WebKit alike — no engine hides a tab of a headless browser. What the browser itself does to a background tab is not emulated: timers are not throttled, animation frames keep running, the page is not frozen, and a service worker's `clients.matchAll()` still reports it visible. `setPage` and `bringToFront` do not show a hidden tab.
|
|
127
|
+
|
|
128
|
+
- a081f17: New: `TestRuntimeManager.inspectState(id)` returns a runtime's snapshot without `vars` — state, last event, failure, result, rollback — and does not walk the scenario's variables. replaces: `inspect(id)` for callers that never read `vars`. Example: `manager.inspectState(id).lastResult`. `inspect(id)` is unchanged and still returns the whole snapshot. The runner's own polls now use it, so a paused or running test builds its variables once per tick instead of three times.
|
|
129
|
+
- c63e688: New: `selectOption(getByLabel('Folder'), {label: 'Archive'})` picks an option by its visible text, and `{index: 0}` by its position, next to the value forms (a string, `{value}`, or an array for a multi-select). replaces: evaluateOnLocator reading an option's value by its text. The call waits for the option; a label or index no option has fails naming the labels the element holds instead of a bare timeout. The validator now checks the value: a misspelt key such as `{lable}` is `validator:options`, before the run and during it, and a number is `validator:arg-kind`. The `explore_step` MCP tool takes the same forms for `select_option`.
|
|
130
|
+
- ceaf212: New: virtual machine steps over Tart — a scenario clones a ready image, boots it and reaches it by IP: `skip('no tart', !vmAvailable()); const vm = vmClone('clean-mac'); const ip = vmRun(vm);`. Each VM is named `unotest-<id>-<n>`, the id random per test, so parallel runs never meet; every VM the test cloned is stopped and deleted when it ends, passed or failed. `vmIp`, `vmStop` and `vmDelete` take only a name `vmClone` returned in the same test — other VMs on the machine are refused, never touched. A boot that fails errors `vmRun` at once with Tart's output instead of waiting out the timeout (default 180 s). Clone and boot are notes in the run's report. replaces: tart by hand.
|
|
131
|
+
- 9e742ac: New: terminal steps drive a real Terminal.app or iTerm2 window on macOS: real key events, the screen read as text, the window framed — `openTerminal('Terminal'); terminalType('my-cli'); terminalPress('Shift+Enter'); terminalWaitForText(/ready/)`. replaces: osascript and expect outside unotest.
|
|
132
|
+
|
|
133
|
+
`openTerminal(app, {host})` opens the window on this Mac, or on another Mac over ssh (`{host: 'admin@192.168.64.38'}`, a Tart VM) through a controller it starts in that Mac's logged-in session; the key comes from your ssh agent or `~/.ssh`. The steps: `openTerminal`, `setTerminal`, `closeTerminal`, `terminalType`, `terminalPress`, `terminalWaitForText`, `terminalAssertText`, `terminalResize`, `terminalScreenshot`. Each lands in the run report like a page step, and a failed test keeps the window's last frame, its screen text and its host in the failure bundle (`terminal.png`, `terminal.txt`, `terminal.json`). Every window a test opened is closed when it ends. A local run takes the keyboard while it types; keys are sent only while the terminal window is in front.
|
|
134
|
+
|
|
135
|
+
- 02e6384: New: `npx @unotest/web upgrade-hints` finds the places in `unotest/e2e/` that do by hand what a typed step does. replaces: reading `lint` info lines one file at a time. It prints the count per pattern, the step to write instead with its section in the DSL guide, and every file and line: a `pause` before checking that an element is absent (`assertNeverAppears`), a `pause` to let an animation settle (`waitForAnimations`) or a control become enabled (`waitFor {state: 'enabled'}`), `getComputedStyle` or `naturalWidth` in page code (`computedStyle`, `getImageSize`), and page code written as a string (a function literal). It shows these rows even when `linter.rules` turns their rule off; a line marked `// lint-ok` is not counted. The first run on a new version shows the counts once: `e2e` prints them, and the MCP `run_test` reply carries them as `upgradeHints` {state: "typed-steps-available", version, hints, next}.
|
|
136
|
+
- bff95c9: BREAKING: `waitForRequest` with a `ws://` or `wss://` mask is refused before the run as `validator:arg-kind`, and by the run, with `WebSockets are not requests: use waitForWebSocket`. A socket's upgrade is no request and the page's request events never see it, so such a wait used to spend its whole timeout and fail.
|
|
137
|
+
|
|
138
|
+
Migration: `waitForRequest('ws://…')` → `waitForWebSocket('ws://…')`.
|
|
139
|
+
|
|
140
|
+
- 52cf309: New: `waitForWebSocket(glob, {timeoutMs?}) → {url}` waits until the active page has opened a WebSocket whose URL matches the mask and returns its URL. A socket the page opened as it loaded counts, so the wait may come after it; a new document starts the list again. A timeout names the mask and the sockets the page did open. replaces: `waitForRequest` on a socket mask, which waited its whole timeout and never saw the socket.
|
|
141
|
+
|
|
142
|
+
Changed: `mockRoute` with a `ws://` or `wss://` mask runs as before and is named with a warning, since it has never had an effect. The reference no longer says a mask reaches WebSockets.
|
|
143
|
+
|
|
144
|
+
`@unotest/dsl`: `refuse` on an argument, strings of the right kind the slot still turns down by how they start, with a sentence and an error or warning level; `refusalMessage`, the text lint and the run give for one.
|
|
145
|
+
|
|
146
|
+
- 80ff1fa: New: `addVirtualAuthenticator()` gives the page a passkey with no person at a device: a virtual WebAuthn authenticator answers `navigator.credentials.create()` and `.get()`. `virtualCredentials(id)` lists what it holds, by base64url id, rpId and sign count, and `removeVirtualAuthenticator(id)` takes it off. replaces: signing in with a passkey by hand in your own browser. Chromium only; Firefox and WebKit fail the call naming the engine. New: `grantPermissions(['notifications'], {origin?})` grants browser permissions to the context; a name the engine does not know fails naming the engine, and earlier grants stay. `setOffline(true)` cuts the context off the network and `setOffline(false)` connects it again. replaces: nothing. Authenticators, permissions and offline are all undone when the context closes.
|
|
147
|
+
|
|
148
|
+
### Patch Changes
|
|
149
|
+
|
|
150
|
+
- 85c9f78: New: `@unotest/dsl/validator` exports `chainReceiverIsArgument(contract)`: whether a chained call of a vocab method gets the receiver as its first argument. replaces: repeating the rule next to the validator. A chain step such as `filter` declares the receiver in its signature. A chainable builder such as `getByRole` keeps the arguments as written. The validator and tools that read a scenario line arguments up by this one rule.
|
|
151
|
+
- 6cd513a: Changed: `dsl_lookup` and `npx @unotest/web api` weigh each word of a query by how few functions hold it, so a rare word decides over common ones: "send the tab to the background and back" now finds `setPageHidden` first instead of `newPage`, `goBack` and `dragAndDrop`. A word that names an option key exactly (`hasNot`, `waitUntil`) counts for the functions that take it: "locator that contains a child element (has, hasNot)" finds `filter` and `locator`. New search words: `background`, `visibility` and `tab hidden` for `setPageHidden`, `faded in` for `waitForAnimations`.
|
|
152
|
+
- f136ad0: Fixed: the refusal of `new X(…)` names the constructors the library has — `new X(…) is not part of the scenario language — use new Map / new Set, the constructors the library has; for anything else …` — so `new Set([1])` running beside a refused `new Error('x')` reads as one rule. The DSL reference and the language page list the constructors from the library itself, and the check that keeps the editor typings fresh keeps that list fresh too.
|
|
153
|
+
- 8d7770d: Fixed: `validator:template-escape-changed` no longer warns on an escape already migrated. It now reports only a backslash escape JavaScript drops — `\s` reads as `s`, `\.` as `.` — the regex text a backtick template used to keep and now silently loses. `\\s`, `\n`, `A` and the other escapes JavaScript reads as meant stay quiet, so doubling the backslash clears the warning without `String.raw` or switching the rule off.
|
|
154
|
+
- 4dec5fc: Fixed: `openTerminal` on a freshly booted macOS VM no longer fails now and then with "Terminal.app cannot be opened … is someone logged in?". The VM answers ssh before its automatic login has made the GUI session; the step now waits for that session (up to 90 s) instead of a fixed 15 s for a single attempt. An image that logs no one in fails the step with what was waited for and how long.
|
|
155
|
+
|
|
156
|
+
Fixed: when `openTerminal(app, {host})` cannot log in to a VM with a key, the hint now gives the commands for the image the VM was cloned from (`tart run <image> &`, `ssh-copy-id admin@$(tart ip --wait 120 <image>)`, `tart stop <image>`) instead of an `ssh-copy-id` to the clone's address, which the run has already deleted, and says that `ssh-copy-id` asks for the image's password.
|
|
157
|
+
|
|
158
|
+
- 7770b39: Fixed: `terminalType` typed the letters of the Mac's current keyboard layout, so under a Russian or another non-US layout the terminal got different text (`clear` arrived as the Cyrillic letters on the same keys). Text now goes in as a paste, line by line with Return between the lines, and the clipboard is restored after. Each line must show on the screen within 2 s, or the step fails quoting the screen's last rows instead of typing on blind; `terminalType(password, {echo: false})` types input a program does not echo. `terminalPress` with a modifier (`Control+c`) presses that key of a US keyboard whatever the layout; a single character alone is pasted, and a character with a modifier but no US key of its own (`Control++`) is refused, naming the key to press (`Control+Shift+=`).
|
|
159
|
+
- bed0e59: Fixed: `openTerminal(app, {host})` on a VM whose image does not hold your ssh key failed with ssh's bare `Permission denied`. It now says that ssh could not log in with a key, and how to put the key in the image once (`ssh-copy-id admin@<ip>` on a booted clone, then stop it) or load it into the ssh agent. The DSL reference shows that one-time step under "Virtual machines": a clean Tart image takes a password only, and the run never passes one.
|
|
160
|
+
- 78ece21: Fixed: `throw new Error('x')` in a scenario is refused with the throw the language has — `throw 'x'` or `throw {message: 'x'}` — instead of the general `new X(…)` advice about object literals and regex literals, in `lint` and in the run alike.
|
|
161
|
+
- 5cfd9b1: Fixed: `lint:typed-step-available` reads page code written as a string too. `evaluate("getComputedStyle(document.body).color")` now gets the hint for `computedStyle(locator, property)` in the same pass as the `validator:page-code-string` info, instead of only after the string was rewritten as a function. Text that does not parse, or that is built at run time, is not read.
|
|
162
|
+
- b613552: New: `e2e` and `lint` in a project without `unotest/jsconfig.json` say once, in one line, to run `npx @unotest/web types`, which writes it so the editor completes the scenario functions. replaces: finding the `types` command on your own. A run still writes no jsconfig itself; the hint is not shown under CI or on a box (`UNOTEST_EDITOR_TYPES=0`), and the project's `.unotest/` remembers it was shown.
|
|
163
|
+
- 54fc118: Changed: the `waitUntil` reference and the Playwright migration guide say where state between tries lives. replaces: a counter declared at the top of the file, which never runs. A counter or the last value seen is a `let` inside the `test_` function or the step, and the body writes it; a top-level `let` is refused by the validator (`validator:unsupported-statement`) and the body then finds no such variable.
|
|
164
|
+
- Updated dependencies [6ea4085]
|
|
165
|
+
- Updated dependencies [ac8f70a]
|
|
166
|
+
- Updated dependencies [1c16eba]
|
|
167
|
+
- Updated dependencies [85c9f78]
|
|
168
|
+
- Updated dependencies [f136ad0]
|
|
169
|
+
- Updated dependencies [355f512]
|
|
170
|
+
- Updated dependencies [c63e688]
|
|
171
|
+
- Updated dependencies [8d7770d]
|
|
172
|
+
- Updated dependencies [78ece21]
|
|
173
|
+
- Updated dependencies [5cfd9b1]
|
|
174
|
+
- Updated dependencies [52cf309]
|
|
175
|
+
- @unotest/dsl@0.51.0
|
|
176
|
+
- @unotest/protocol@0.51.0
|
|
177
|
+
- @unotest/viewer@0.51.0
|
|
178
|
+
- @unotest/core@0.51.0
|
|
179
|
+
- @unotest/grounder-client@0.51.0
|
|
180
|
+
|
|
3
181
|
## [0.50.0] - 2026-10-14
|
|
4
182
|
|
|
5
183
|
### Minor Changes
|
|
6
184
|
|
|
185
|
+
- Breaking, added after the release: `apiCall` takes at most five arguments: method, path, body, headers and options. 0.49.2 dropped a sixth one without a word, so a call such as `apiCall('GET', '/status', null, {}, {base: 'API_BASE'}, {timeout: 120000})` ran as if the sixth were not there. 0.50.0 refuses it: `apiCall() takes at most 5 arguments, got 6 — remove the extra argument`, and the test ends errored.
|
|
186
|
+
|
|
187
|
+
Migration: remove the sixth argument. The call never read it, so it behaves as it did in 0.49.2. A per-call timeout for `apiCall` is a separate feature of a later release.
|
|
188
|
+
|
|
189
|
+
- Breaking, added after the release: a backslash escape in a backtick template now means what it means in JavaScript. Before 0.50.0 it was kept as written. The change is silent for page code: `` evaluateOnLocator(loc, `(el) => /\s+/.test(el.textContent)`) `` reaches the page as `/s+/`, the regex looks for the letter `s`, and the check gives a wrong answer with no error. The lint warning `template-escape-changed` marks every such template.
|
|
190
|
+
|
|
191
|
+
Migration: in a template, write a backslash meant for the page as `\\` (`/\\s+/`), or wrap the template in `String.raw` to keep the text as written. Better, pass the page code as a function, `evaluateOnLocator(loc, (el) => /\s+/.test(el.textContent))`: the validator reads it with the file and no escape is involved.
|
|
192
|
+
|
|
7
193
|
- e176cb4: Scenarios are read by the new JavaScript parser and run by the new interpreter: `run`, `e2e`, `lint`, `explore_run_flow`, the viewer's editor and the bundle checks all go through it.
|
|
8
194
|
|
|
9
195
|
`evaluate` and `evaluateOnLocator` take a function as the page code: `evaluate((n) => document.querySelectorAll('li').length > n, 3)`, `evaluateOnLocator(loc, (el) => el.dataset.state)`. The page gets the function as it is written, like Playwright's `fn.toString()`, so it sees none of the scenario's variables: values go in as the arguments after it. The string form works as before, and the advice of 0.49.2 to pass the function as a quoted string no longer applies. A function anywhere else in a host call is still refused.
|
|
@@ -2104,7 +2290,7 @@ picker on` fetches this project's own access and writes the three grounder
|
|
|
2104
2290
|
|
|
2105
2291
|
That screen named one command:
|
|
2106
2292
|
|
|
2107
|
-
|
|
2293
|
+
npx @unotest/web bundle push --run --env ENVIRONMENT
|
|
2108
2294
|
|
|
2109
2295
|
In a project that has just been created, the command refuses with `no box
|
|
2110
2296
|
address` before it does anything: the project holds neither the box's address
|
|
@@ -2113,8 +2299,8 @@ address` before it does anything: the project holds neither the box's address
|
|
|
2113
2299
|
|
|
2114
2300
|
The screen now names both steps, in the order they have to happen:
|
|
2115
2301
|
|
|
2116
|
-
|
|
2117
|
-
|
|
2302
|
+
npx @unotest/web box access larch
|
|
2303
|
+
npx @unotest/web bundle push --run --env ENVIRONMENT
|
|
2118
2304
|
|
|
2119
2305
|
The box's own name is filled in when its licence carries one. `box access`
|
|
2120
2306
|
with no name refuses, and its refusal offers to create a box — to somebody who
|
package/README.md
CHANGED
|
@@ -12,6 +12,31 @@ Full documentation — manuals, the box, CI, the judge — lives at
|
|
|
12
12
|
tour; the package ships only `guides/dsl-reference.md` and
|
|
13
13
|
`guides/agent-integration.md` alongside it.
|
|
14
14
|
|
|
15
|
+
<!-- generated:api-index — generated from the DSL vocabulary (pnpm build:api-index), do not edit -->
|
|
16
|
+
## What unotest can do
|
|
17
|
+
|
|
18
|
+
Scenarios are JavaScript calling these functions. `npx @unotest/web api <word>`
|
|
19
|
+
prints one line per function — signature, options, the release that added it,
|
|
20
|
+
when you need it — and finds it by the habit you know: `api sleep`,
|
|
21
|
+
`api clipboard`, `api not appear`. The same index ships as `llms.txt` in the
|
|
22
|
+
package; the full reference is at https://docs.unotest.com/reference/dsl/.
|
|
23
|
+
|
|
24
|
+
- **Navigation** — `goto`, `reload`, `goBack`, `goForward`, `waitForUrl`, `waitForNavigation`
|
|
25
|
+
- **Locators** — `locator`, `getByRole`, `getByText`, `getByLabel`, `getByPlaceholder`, `getByAltText`, `getByTitle`, `getByTestId`, `contentFrame`
|
|
26
|
+
- **Refining a locator** — `filter`, `first`, `last`, `nth`, `randomNth`
|
|
27
|
+
- **Actions** — `click`, `doubleClick`, `check`, `uncheck`, `hover`, `scrollIntoView`, `fill`, `press`, `selectOption`, `dragAndDrop`, `uploadFile`, `clipboardPaste`
|
|
28
|
+
- **Waits and the page clock** — `waitFor`, `waitForText`, `waitForCount`, `waitForAnimations`, `pause`, `waitForDownload`, `clockFreeze`, `clockTick`, `clockRun`
|
|
29
|
+
- **Assertions** — `assertText`, `assertTexts`, `assertAttribute`, `assertVisible`, `assertHidden`, `assertNeverAppears`, `assertValue`, `assertCount`, `assertUrl`, `assertJudge`, `assertScreenshot`, `assertEqual`, `assertTrue`, `assertSchema`, `assertFileHas`, `assertFileLacks`, `skip`, `setTestTimeout`
|
|
30
|
+
- **Reading the page and values** — `clipboardRead`, `assertClipboard`, `count`, `textContent`, `texts`, `inputValue`, `isVisible`, `isChecked`, `isDisabled`, `isEnabled`, `hasAttribute`, `computedStyle`, `getImageSize`, `hasAnimation`, `animations`, `randomFirstName`, `randomLastName`, `randomEmail`, `randomText`, `randomWord`, `json`, `textContains`, `textJoin`, `nowMs`, `today`, `daysFromNow`, `textMatches`, `parseJson`, `urlParam`, `toNumber`, `round`, `formatNumber`, `env`
|
|
31
|
+
- **Page state** — `getAttribute`, `getInnerText`, `getInputValue`, `boundingBox`, `getTitle`, `getUrl`, `log`
|
|
32
|
+
- **Storage and cookies** — `setLocalStorage`, `getLocalStorage`, `setCookie`, `getCookie`
|
|
33
|
+
- **Tabs, frames, contexts, extensions** — `setPage`, `waitForPage`, `bringToFront`, `setPageHidden`, `newPage`, `closePage`, `setViewport`, `emulateMedia`, `newContext`, `setContext`, `enterFrame`, `exitFrame`, `addVirtualAuthenticator`, `virtualCredentials`, `removeVirtualAuthenticator`, `grantPermissions`, `setOffline`, `waitForServiceWorker`, `extensionId`, `evaluateInServiceWorker`
|
|
34
|
+
- **Data, files, network, processes** — `shell`, `waitForFile`, `assertNoFile`, `waitForJsonLine`, `assertNoJsonLine`, `readJsonLine`, `readJson`, `readFile`, `readFileInfo`, `waitForFileCount`, `assertFileCount`, `dbQuery`, `dbExec`, `apiCall`, `upload`, `mockRoute`, `unmockRoute`, `waitForRequest`, `waitForWebSocket`, `assertNoRequest`, `openTerminal`, `setTerminal`, `closeTerminal`, `terminalType`, `terminalPress`, `terminalWaitForText`, `terminalAssertText`, `terminalResize`, `terminalScreenshot`, `mcpStart`, `mcpCall`, `mcpWaitNotification`, `mcpStop`, `vmAvailable`, `vmClone`, `vmRun`, `vmIp`, `vmStop`, `vmDelete`
|
|
35
|
+
- **Diagnostics** — `screenshot`, `note`, `consoleEntries`, `pageErrors`, `assertNoConsoleErrors`
|
|
36
|
+
- **Structure** — `step`, `teardown`, `waitUntil`, `assertNever`
|
|
37
|
+
- **Page code (last resort)** — `evaluate`, `evaluateOnLocator`
|
|
38
|
+
<!-- /generated:api-index -->
|
|
39
|
+
|
|
15
40
|
---
|
|
16
41
|
|
|
17
42
|
## 1. Setup
|
package/bin/unotest-web.js
CHANGED
|
@@ -99,7 +99,8 @@ function dispatch(sub) {
|
|
|
99
99
|
// arguments belong to the command, not to the dispatcher.
|
|
100
100
|
return cliRoute(args);
|
|
101
101
|
case "viewer":
|
|
102
|
-
|
|
102
|
+
// Forwarded whole: `--open` belongs to the command.
|
|
103
|
+
return cliRoute(args);
|
|
103
104
|
case "prepare-fix":
|
|
104
105
|
return {
|
|
105
106
|
dist: "dist/runner/prepare-fix.js",
|