@rehearsal-labs/retest 0.1.0 → 0.2.0

package/dist/api/locator-recipes.d.ts

@@ -33,7 +33,7 @@ export declare function textRecipe(by: 'label' | 'text' | 'placeholder', text: u
 export declare function cssRecipe(selector: unknown): BuiltRecipe;
 /**
  * A recipe scoped inside another: the outer recipe's steps, then the inner one's, which finds elements inside those
- * the outer one keeps.
+ * the outer one keeps, in the frame the outer one is in.
  *
  * @example scopedRecipe({ by: 'testId', value: 'tasks' }, { by: 'role', role: 'listitem' }) // { by: 'role', role: 'listitem', within: [{ by: 'testId', value: 'tasks' }] }
  */

package/dist/api/locator-recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locator-recipes.d.ts","sourceRoot":"","sources":["../../src/api/locator-recipes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,aAAa,EAAa,MAAM,wBAAwB,CAAA;AAOnF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAM3F;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,WAAW,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CASvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAS7G;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAIxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAGtF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAK3H"}
+{"version":3,"file":"locator-recipes.d.ts","sourceRoot":"","sources":["../../src/api/locator-recipes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,aAAa,EAAa,MAAM,wBAAwB,CAAA;AAOnF,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAM3F;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,WAAW,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CASvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAS7G;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAIxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAItF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAK3H"}

package/dist/api/locator-recipes.js

@@ -65,13 +65,14 @@ export function cssRecipe(selector) {
 }
 /**
  * A recipe scoped inside another: the outer recipe's steps, then the inner one's, which finds elements inside those
- * the outer one keeps.
+ * the outer one keeps, in the frame the outer one is in.
  *
  * @example scopedRecipe({ by: 'testId', value: 'tasks' }, { by: 'role', role: 'listitem' }) // { by: 'role', role: 'listitem', within: [{ by: 'testId', value: 'tasks' }] }
  */
 export function scopedRecipe(outer, inner) {
-    const { within: _innerScope, dialect: _innerDialect, ...step } = inner;
-    return { ...step, within: locatorSteps(outer), ...(outer.dialect === undefined ? {} : { dialect: outer.dialect }) };
+    const { within: _innerScope, dialect: _innerDialect, frame: _innerFrame, ...step } = inner;
+    const dialect = outer.dialect === undefined ? {} : { dialect: outer.dialect };
+    return { ...step, within: locatorSteps(outer), ...dialect, ...(outer.frame === undefined ? {} : { frame: outer.frame }) };
 }
 /**
  * The recipe `first()`, `last()` or `nth(index)` makes: the same steps, keeping one match of the last. A locator

package/dist/api/page.d.ts

@@ -1,7 +1,11 @@
 import type { RetestTypeError, TestIdValue } from '../config/register.ts';
 import type { NativePlatform } from '../config/types.ts';
 import type { AriaRole } from '../protocol/aria-role.ts';
+import type { DialogType } from '../protocol/dialogs.ts';
+import type { AbortReason } from '../protocol/routes.ts';
 import type { CallOptions } from './call-options.ts';
+import type { DragOptions } from './drag.ts';
+import type { InboxLink } from './inbox.ts';
 import type { KeyArgument } from './key-argument.ts';
 import type { Secret } from './secret.ts';
 /**
@@ -67,11 +71,12 @@ export interface Finders<Touch extends boolean = boolean> {
  */
 export interface Page<Touch extends boolean = boolean> extends Finders<Touch> {
     /**
-     * Opens a URL and waits for the page to load. A relative URL resolves against the app's base URL.
+     * Opens a URL and waits for the page to load. A relative URL resolves against the app's base URL. A link from an
+     * inbox's message is opened by the process that runs Retest, which never hands its address to the test.
      *
      * @example await page.goto('/')
      */
-    goto(url: string, options?: CallOptions): Promise<void>;
+    goto(url: string | InboxLink, options?: CallOptions): Promise<void>;
     /**
      * Reloads the page and waits for it to load.
      *
@@ -105,6 +110,14 @@ export interface Page<Touch extends boolean = boolean> extends Finders<Touch> {
      * @example const title = await page.title()
      */
     title(): Promise<string>;
+    /**
+     * The frame shown by the `<iframe>` or `<frame>` element `locator` finds on this page, a frame of another site
+     * included. The element is found again for every use, so a frame that is removed and added again is found again. Its
+     * finders find elements inside the frame's document.
+     *
+     * @example const payment = page.frame(page.locator('iframe[title="Secure payment"]'))
+     */
+    frame(locator: Locator<Touch>): Frame<Touch>;
     /** The keyboard of this app's page. It presses keys on whatever holds the keyboard focus. */
     readonly keyboard: Keyboard;
     /**
@@ -114,13 +127,192 @@ export interface Page<Touch extends boolean = boolean> extends Finders<Touch> {
      * @example await page.scroll({ y: 600 })
      */
     scroll(delta: ScrollDelta, options?: CallOptions): Promise<void>;
+    /**
+     * Runs `action` and gives the JavaScript dialog it opens, as soon as it opens: an alert, a confirm, a prompt or a
+     * `beforeunload` confirmation. The page is armed before the action runs. A dialog holds the page, so the action is
+     * still waiting when this resolves, and finishes once the test answers the dialog: await this, then await
+     * `dialog.accept()` or `dialog.dismiss()`, which resolves once the action is over too. The wait lasts the action budget,
+     * or a shorter `{ timeout }`. A dialog nothing waited for fails the action that opened it, and Retest dismisses it.
+     *
+     * @example
+     * const dialog = await page.dialog(() => page.getByRole('button', { name: 'Delete' }).click())
+     * await dialog.accept()
+     */
+    dialog(action: () => Promise<unknown>, options?: CallOptions): Promise<Dialog>;
+    /**
+     * Runs `action` and gives the page it opens, by `window.open`, a link with a target or a form, as a page of its own:
+     * its commands, checks and failure screenshot are its own, and it closes when the test ends. The page is armed before
+     * the action runs, and this resolves once the new page has opened its first document and the action is over. The wait
+     * lasts the action budget, or a shorter `{ timeout }`. A page opened while nothing waited runs on unwatched.
+     *
+     * @example const terms = await page.popup(() => page.getByRole('link', { name: 'Terms' }).click())
+     */
+    popup(action: () => Promise<unknown>, options?: CallOptions): Promise<Page<Touch>>;
+    /**
+     * Closes a page the app opened, which `page.popup()` gave, and waits for it to go. Its `beforeunload` handlers run
+     * first; answer their dialog with `page.dialog()`. The test's own pages close when the test ends.
+     *
+     * @example await terms.close()
+     */
+    close(options?: CallOptions): Promise<void>;
+    /**
+     * Runs `action` and gives the file picker it opens, which is never shown, so its input can be given files. The wait
+     * for the picker starts before the action, and lasts the action budget or a shorter `{ timeout }`. A picker the test
+     * did not wait for fails the action that opened it.
+     *
+     * @example const chooser = await page.fileChooser(() => page.getByRole('button', { name: 'Upload' }).click())
+     */
+    fileChooser(action: () => Promise<unknown>, options?: CallOptions): Promise<FileChooser>;
+    /**
+     * Runs `action` and gives the download it starts. The wait for it starts before the action, and lasts the action
+     * budget or a shorter `{ timeout }`. The run folder keeps every download a page makes, under the name the page
+     * suggested, whether or not a test waits for it.
+     *
+     * @example const download = await page.download(() => page.getByRole('link', { name: 'Export CSV' }).click())
+     */
+    download(action: () => Promise<unknown>, options?: CallOptions): Promise<Download>;
+    /**
+     * Answers every request of the page whose whole address `pattern` matches with `answer`, in the network's place, from
+     * now on: a response, or a refusal. A later route answers before an earlier one. It resolves once the page holds the
+     * route, so the next `goto` meets it. A popup shares the routes of the page that opened it.
+     *
+     * @example await page.route('http://127.0.0.1:4173/api/tasks', { contentType: 'application/json', body: JSON.stringify([{ title: 'Stubbed' }]) })
+     */
+    route(pattern: RoutePattern, answer: RouteAnswer): Promise<void>;
+    /**
+     * Removes every route added with `pattern`, written as it was added. A pattern that matches no route fails.
+     *
+     * @example await page.unroute(/\/api\/tasks$/)
+     */
+    unroute(pattern: RoutePattern): Promise<void>;
+}
+/**
+ * A frame of an app's page: the document an `<iframe>` or `<frame>` element shows, found again by that element's
+ * locator for every use. Its finders find elements inside that document, through its open shadow roots, and `frame()`
+ * a frame inside it. It has no address of its own to go to: `goto`, `toHaveURL` and `toHaveTitle` are the page's.
+ */
+export interface Frame<Touch extends boolean = boolean> extends Finders<Touch> {
+    /**
+     * The frame shown by the `<iframe>` or `<frame>` element `locator` finds in this frame's document.
+     *
+     * @example const notes = order.frame(order.locator('iframe'))
+     */
+    frame(locator: Locator<Touch>): Frame<Touch>;
 }
+/**
+ * A JavaScript dialog an action opened: an alert, a confirm, a prompt or a `beforeunload` confirmation. It holds the page
+ * until the test answers it, and the action that opened it finishes only then, so `accept()` and `dismiss()` each
+ * resolve once the dialog is answered and that action is over. Answer each dialog once.
+ */
+export interface Dialog {
+    /** The kind of dialog the page opened. */
+    readonly type: DialogType;
+    /** The text the page showed, with every value the run hides replaced. A `beforeunload` dialog's is empty. */
+    readonly message: string;
+    /** A prompt's default answer, and empty for any other dialog. */
+    readonly defaultValue: string;
+    /**
+     * Accepts the dialog, as its OK button does. A prompt takes the text to answer with, and without it answers with its
+     * default. A `beforeunload` dialog accepted lets the page leave.
+     *
+     * @example await dialog.accept('Ada')
+     */
+    accept(promptText?: string): Promise<void>;
+    /**
+     * Dismisses the dialog, as its Cancel button does. A prompt dismissed answers `null`; a `beforeunload` dialog
+     * dismissed keeps the page where it is, so the navigation that asked fails.
+     *
+     * @example await dialog.dismiss()
+     */
+    dismiss(): Promise<void>;
+}
+/**
+ * A file picker a `page.fileChooser()` caught: the operating system's picker was never shown, and the page waits for
+ * the files its input is given here.
+ */
+export interface FileChooser {
+    /** Whether the picker's input takes several files, as its `multiple` attribute says. */
+    readonly multiple: boolean;
+    /**
+     * Gives the picker's input the files, as a person choosing them would, so the page hears its `input` and `change`
+     * events. A path is read against the folder of the file that makes the call.
+     *
+     * @example await chooser.setFiles('./fixtures/report.pdf')
+     */
+    setFiles(files: InputFiles, options?: CallOptions): Promise<void>;
+}
+/**
+ * A download a `page.download()` caught. The process that runs Retest saves it in the run folder, under the name the
+ * page suggested, whether or not the test asks for it.
+ */
+export interface Download {
+    /** The name the browser suggested for the file, from the page's `download` attribute or the server's answer. */
+    readonly suggestedFilename: string;
+    /**
+     * Waits for the download to be saved, within the navigation budget or a shorter `{ timeout }`, and gives the absolute
+     * path of its file in the run folder. A download the browser stopped fails, saying how much of it arrived.
+     *
+     * @example const csv = await readFile(await download.path(), 'utf8')
+     */
+    path(options?: CallOptions): Promise<string>;
+    /**
+     * Waits for the download to be saved, as `path()` does, then copies its file to `path`, read against the folder of the
+     * file that makes the call, making the folders it needs. The run folder keeps its own copy.
+     *
+     * @example await download.saveAs('./out/tasks.csv')
+     */
+    saveAs(path: string, options?: CallOptions): Promise<void>;
+}
+/**
+ * A file given by its content rather than a path: the name the page reads, its bytes or its text, which is written as
+ * UTF-8, and, when given, the type the page must read for it. The browser types a file by the end of its name, so a
+ * `mimeType` it does not give the file fails the call.
+ */
+export type FilePayload = {
+    readonly name: string;
+    readonly mimeType?: string | undefined;
+    readonly content: string | Uint8Array;
+};
+/**
+ * The files an input takes: a path, read against the folder of the file that makes the call, as an import is; a file by
+ * its content; or a list of them. An empty list clears the input.
+ */
+export type InputFiles = string | FilePayload | readonly (string | FilePayload)[];
+/**
+ * Which requests a route answers: a glob of the whole address, query included, where `**` matches any run of characters
+ * and `*` any run without a `/`; or a `RegExp` searched for in the address.
+ */
+export type RoutePattern = string | RegExp;
+/**
+ * A response a route gives in the network's place: `status`, 200 unless given, `headers`, `contentType`, which sets the
+ * `Content-Type` header, and `body`, text written as UTF-8, or bytes.
+ */
+export type RouteFulfil = {
+    readonly status?: number | undefined;
+    readonly headers?: Readonly<Record<string, string>> | undefined;
+    readonly contentType?: string | undefined;
+    readonly body?: string | Uint8Array | undefined;
+    readonly abort?: never;
+};
+/** A refusal: the request fails as Chrome's network error `abort` names, such as `'connectionrefused'`. */
+export type RouteAbort = {
+    readonly abort: AbortReason;
+    readonly status?: never;
+    readonly headers?: never;
+    readonly contentType?: never;
+    readonly body?: never;
+};
+/** What a route answers each request it matches with: a response, or a refusal. Never both. */
+export type RouteAnswer = RouteFulfil | RouteAbort;
 /**
  * An Electron app's page in a test: the first window the app opens. It finds, acts and checks as a web page does, and
  * reloads and moves through its history, but it has no address to go to.
  */
-export type ElectronPage = Omit<Page<false>, 'goto'> & {
+export type ElectronPage = Omit<Page<false>, 'goto' | 'popup' | 'route' | 'unroute'> & {
     readonly goto: RetestTypeError<'An Electron app has no address. Its page is the first window the app opens.'>;
+    readonly popup: RetestTypeError<"A test reaches only an Electron app's first window. popup() is for a browser's page.">;
+    readonly route: RetestTypeError<"Retest does not answer an Electron app's requests yet. route() is for a browser's page.">;
+    readonly unroute: RetestTypeError<"Retest does not answer an Electron app's requests yet. unroute() is for a browser's page.">;
 };
 /** An app's keyboard. Await each press, because an app takes one command at a time. */
 export interface Keyboard {
@@ -158,7 +350,8 @@ export interface Locator<Touch extends boolean = boolean> extends Finders<Touch>
      */
     nth(index: number): Locator<Touch>;
     /**
-     * Replaces the field's value by typing, as a person would. A secret is typed by the process that runs Retest.
+     * Replaces the field's value by typing, as a person would. A secret, or a code from an inbox's message, is typed by
+     * the process that runs Retest.
      *
      * @example await page.getByLabel('Password').fill(secret('password'))
      */
@@ -215,6 +408,23 @@ export interface Locator<Touch extends boolean = boolean> extends Finders<Touch>
      * @example await page.getByTestId('terms').scroll({ y: 600 })
      */
     scroll(delta: ScrollDelta, options?: CallOptions): Promise<void>;
+    /**
+     * Gives an `<input type="file">` the files, in place of those it held, as a person choosing them in the picker
+     * would: the page hears its `input` and `change` events. The input must be there and enabled, and need not be
+     * visible. A path is read against the folder of the file that makes the call; an empty list clears the input.
+     *
+     * @example await page.getByLabel('Attachment').setInputFiles('./fixtures/report.pdf')
+     */
+    setInputFiles(files: InputFiles, options?: CallOptions): Promise<void>;
+    /**
+     * Drags the element onto the element `target` finds, once both are visible, stable and not covered, in view
+     * together: it presses the mouse at the element's centre, moves it through `steps` positions, 5 unless given, to the
+     * target's centre, and releases it there. When the page begins an HTML drag, the browser's drag events carry it to
+     * the target, so the page's `drop` handler reads its `dataTransfer`.
+     *
+     * @example await page.getByText('Write release notes').dragTo(page.getByTestId('done-column'))
+     */
+    dragTo(target: Locator, options?: DragOptions): Promise<void>;
     /**
      * Taps the element's centre, on an app whose every target has a touch screen.
      *

package/dist/api/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/api/page.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/api/page.ts"],"names":[],"mappings":"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"}

package/dist/api/route.d.ts

@@ -0,0 +1,21 @@
+import type { TestRun } from './test-run.ts';
+/** The test and app behind a page. */
+type PageTarget = {
+    readonly run: TestRun;
+    readonly app: string;
+};
+/**
+ * Adds a route to the app's page: from now on every request of the page whose address `pattern` matches is answered
+ * with `answer`, before any route added earlier. Resolves once the page holds it.
+ *
+ * @example await route(page, 'http://127.0.0.1:4173/api/tasks', { status: 200, contentType: 'application/json', body: '[]' })
+ */
+export declare function route({ run, app }: PageTarget, pattern: unknown, answer: unknown): Promise<void>;
+/**
+ * Removes every route of the app's page added with `pattern`, written as it was. Resolves once the page holds the change.
+ *
+ * @example await unroute(page, 'http://127.0.0.1:4173/api/tasks')
+ */
+export declare function unroute({ run, app }: PageTarget, pattern: unknown): Promise<void>;
+export {};
+//# sourceMappingURL=route.d.ts.map

package/dist/api/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/api/route.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAQ5C,sCAAsC;AACtC,KAAK,UAAU,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAIjE;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhG;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjF"}

package/dist/api/route.js

@@ -0,0 +1,99 @@
+import { textPatternOf } from "../protocol/locator.js";
+import { abortReasons, describeRoutePattern, routeAnswerProblem, routePatternProblem } from "../protocol/routes.js";
+import { isPlainObject } from "../protocol/schema.js";
+import { listWords } from "../shared/list-words.js";
+import { formatValue } from "./format-value.js";
+import { misuse } from "./misuse.js";
+const fulfilKeys = new Set(['status', 'headers', 'contentType', 'body']);
+/**
+ * Adds a route to the app's page: from now on every request of the page whose address `pattern` matches is answered
+ * with `answer`, before any route added earlier. Resolves once the page holds it.
+ *
+ * @example await route(page, 'http://127.0.0.1:4173/api/tasks', { status: 200, contentType: 'application/json', body: '[]' })
+ */
+export function route({ run, app }, pattern, answer) {
+    const location = run.location();
+    const read = readPattern(pattern, 'route', run);
+    const record = readAnswer(answer, run);
+    return run.changeRoutes({ app, label: `page.route(${describeRoutePattern(read)})`, request: { kind: 'add', pattern: read, answer: record }, location });
+}
+/**
+ * Removes every route of the app's page added with `pattern`, written as it was. Resolves once the page holds the change.
+ *
+ * @example await unroute(page, 'http://127.0.0.1:4173/api/tasks')
+ */
+export function unroute({ run, app }, pattern) {
+    const location = run.location();
+    const read = readPattern(pattern, 'unroute', run);
+    return run.changeRoutes({ app, label: `page.unroute(${describeRoutePattern(read)})`, request: { kind: 'remove', pattern: read }, location });
+}
+function readPattern(pattern, method, run) {
+    const read = typeof pattern === 'string' ? pattern : pattern instanceof RegExp ? textPatternOf(pattern) : undefined;
+    if (read === undefined)
+        throw misuse(`page.${method}() takes a glob of the whole address, such as '**/api/tasks', or a RegExp, received ${formatValue(pattern)}.`, run);
+    const problem = routePatternProblem(read, method);
+    if (problem !== undefined)
+        throw misuse(problem, run);
+    return read;
+}
+// An answer is data, since no function crosses to the process that runs the browser: each part is read as the wire
+// carries it, and a body of bytes goes as base64.
+function readAnswer(answer, run) {
+    if (!isPlainObject(answer))
+        throw misuse(`page.route() takes an answer such as { status: 200, body: 'ok' } or { abort: 'connectionrefused' }, received ${formatValue(answer)}.`, run);
+    const given = Object.entries(answer).filter(([, value]) => value !== undefined);
+    const unknown = given.find(([key]) => key !== 'abort' && !fulfilKeys.has(key));
+    if (unknown !== undefined)
+        throw misuse(`page.route() has no answer option ${JSON.stringify(unknown[0])}. An answer takes status, headers, contentType and body, or abort.`, run);
+    const parts = Object.fromEntries(given);
+    if ('abort' in parts) {
+        if (given.length > 1)
+            throw misuse('page.route() takes an answer that gives a response or one that aborts the request, not both.', run);
+        const reason = abortReasons.find((each) => each === parts['abort']);
+        if (reason === undefined)
+            throw misuse(`page.route() takes abort as one of ${listWords(abortReasons.map((each) => `'${each}'`), 'or')}, received ${formatValue(parts['abort'])}.`, run);
+        return { abort: reason };
+    }
+    const record = { ...status(parts['status'], run), ...headers(parts['headers'], run), ...contentType(parts['contentType'], run), ...body(parts['body'], run) };
+    const problem = routeAnswerProblem(record);
+    if (problem !== undefined)
+        throw misuse(problem, run);
+    return record;
+}
+function status(value, run) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'number')
+        throw misuse(`page.route() takes status as a number, such as 404, received ${formatValue(value)}.`, run);
+    return { status: value };
+}
+function headers(value, run) {
+    if (value === undefined)
+        return {};
+    const refused = () => misuse(`page.route() takes headers as names with text values, such as { 'x-total': '3' }, received ${formatValue(value)}.`, run);
+    if (!isPlainObject(value))
+        throw refused();
+    const read = {};
+    for (const [name, header] of Object.entries(value)) {
+        if (typeof header !== 'string')
+            throw refused();
+        read[name] = header;
+    }
+    return { headers: read };
+}
+function contentType(value, run) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'string')
+        throw misuse(`page.route() takes contentType as text, such as 'application/json', received ${formatValue(value)}.`, run);
+    return { contentType: value };
+}
+function body(value, run) {
+    if (value === undefined)
+        return {};
+    if (typeof value === 'string')
+        return { body: value };
+    if (value instanceof Uint8Array)
+        return { base64: Buffer.from(value.buffer, value.byteOffset, value.byteLength).toString('base64') };
+    throw misuse(`page.route() takes a body as text or bytes, received ${formatValue(value)}.`, run);
+}

package/dist/api/test-run.d.ts

@@ -2,9 +2,16 @@ import type { ObserveAfter, CommandResult, PageCommand } from '../protocol/comma
 import type { EvaluationAnswer, EvaluationCall } from '../protocol/evaluation.ts';
 import type { ChildEvent } from '../protocol/events.ts';
 import type { Failure, SourceLocation } from '../protocol/failures.ts';
+import type { DialogAnswer, DialogRecord } from '../protocol/dialogs.ts';
+import type { FilesAnswer, FilesRequest } from '../protocol/files.ts';
+import type { RouteReply, RouteRequest } from '../protocol/routes.ts';
+import type { InboxAnswer, InboxRequest, ReceivedMessageRecord } from '../protocol/inbox.ts';
+import type { LayoutRequest } from '../protocol/layout-checks.ts';
 import type { LocatorRecipe } from '../protocol/locator.ts';
 import type { ChildMessage } from '../protocol/messages.ts';
+import type { ScreenshotRequest } from '../protocol/screenshot.ts';
 import type { Timeouts } from '../protocol/timeouts.ts';
+import type { PopupAnswer, PopupRecord } from '../protocol/popups.ts';
 import type { RunTime } from './run-time.ts';
 import type { RunnableTest } from './test-body.ts';
 import { RetestError } from './failure.ts';
@@ -27,6 +34,58 @@ export type TestRunOptions = {
     /** The clock the test's budgets and durations count on, and the waits assertions poll with. The host's by default. */
     time?: RunTime;
 };
+/**
+ * A read of an inbox as the test asked for it: the call as the test wrote it, what it asks for, where the test sent it
+ * from, and the time it gave itself with `{ timeout }`, when it gave one.
+ */
+export type InboxReading = {
+    readonly label: string;
+    readonly request: InboxRequest;
+    readonly location: SourceLocation | undefined;
+    readonly timeoutMs?: number;
+};
+/**
+ * A wait the parent makes about files, as the test asked for it: the call as the test wrote it, what it waits for, where
+ * the test sent it from, and its time in milliseconds, before the test's own time left cuts it.
+ */
+export type FilesWaiting = {
+    readonly label: string;
+    readonly request: FilesRequest;
+    readonly location: SourceLocation | undefined;
+    readonly timeoutMs: number;
+};
+/**
+ * A wait for what an action opens on an app's page, as the test asked for it: the app, the call as the test wrote it,
+ * where the test sent it from, the time it gave itself with `{ timeout }`, when it gave one, and the action, which the
+ * wait runs once the page is armed.
+ */
+export type OpeningWait = {
+    readonly app: string;
+    readonly label: string;
+    readonly location: SourceLocation | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly action: () => Promise<unknown>;
+};
+/**
+ * An answer to a dialog the test was given: the app whose page shows it, its id, whether to accept it and the text a
+ * prompt takes, the call as the test wrote it and where, and the action that opened it, which the answer waits for.
+ */
+export type DialogAnswering = {
+    readonly app: string;
+    readonly dialog: string;
+    readonly accept: boolean;
+    readonly promptText?: string | undefined;
+    readonly label: string;
+    readonly location: SourceLocation | undefined;
+    readonly acted: Promise<void>;
+};
+/** A change to an app's routes, as the test asked for it: the app, the call as the test wrote it, and where it was sent from. */
+export type RouteChange = {
+    readonly app: string;
+    readonly label: string;
+    readonly request: RouteRequest;
+    readonly location: SourceLocation | undefined;
+};
 /** How a test ended, as the child reports it. */
 export type Verdict = {
     status: 'passed' | 'failed';
@@ -35,7 +94,7 @@ export type Verdict = {
     durationMs: number;
 };
 type ActionCommand = Exclude<PageCommand, {
-    kind: 'observe' | 'observePage';
+    kind: 'observe' | 'observePage' | 'observeLayout' | 'observeScreenshot';
 }>;
 /**
  * One test running in the child. It runs the test's hooks and function, sends each app's commands one at a
@@ -78,6 +137,62 @@ export declare class TestRun {
      * earlier test never reaches a later one.
      */
     requestEvaluation(call: EvaluationCall, location: SourceLocation | undefined): Promise<EvaluationAnswer>;
+    /**
+     * Asks the parent to read an inbox. The parent reads the mailbox, looks again until a message arrives or the read's
+     * time runs out, and answers with the message, its codes and links hidden; `wrap` turns that answer into what the
+     * test receives. The read touches no page, so it holds no app, and it starts at once. Its time is its own `timeoutMs`,
+     * or the assertion budget, cut to what the test has left. It changes what the next read gives, so it may not run
+     * inside the function `expect.poll` calls.
+     */
+    readInbox<T>({ label, request, location, timeoutMs }: InboxReading, wrap: (message: ReceivedMessageRecord) => T): Operation<T>;
+    resolveInbox(id: number, answer: InboxAnswer): void;
+    /**
+     * Asks the parent to arm an app's page for the next JavaScript dialog, runs the action once the page is armed, and
+     * resolves with what `wrap` makes of the dialog as soon as it opens. The action is still waiting then, since a page
+     * holds the input that opened a dialog until the dialog is answered; `wrap` is given the action's own promise, which
+     * settles once the action does. An action that fails before any dialog opened fails the wait with its own failure,
+     * and the parent stops waiting. A wait that sees no dialog in its time fails, unless its action failed meanwhile,
+     * whose failure it gives instead. The wait acts on a page, so it may not run inside the function `expect.poll` calls.
+     */
+    waitForDialog<T>(wait: OpeningWait, wrap: (dialog: DialogRecord, acted: Promise<void>) => T): Operation<T>;
+    /**
+     * As `waitForDialog`, for the next page the action opens: the parent hands it over as an app of its own, and the wait
+     * resolves with what `wrap` makes of it once the action is over too, so the next command to the page that opened it
+     * never meets the action still running. An action that fails fails the wait with its own failure.
+     */
+    waitForPopup<T>(wait: OpeningWait, wrap: (popup: PopupRecord) => T): Operation<T>;
+    /**
+     * Asks the parent to answer a dialog the test was given, then waits for the action that opened it, so the answer's
+     * step ends once its action has. An answer the parent could not give fails, and an action that failed fails it too,
+     * with its own failure. It acts on a page, so it may not run inside the function `expect.poll` calls.
+     */
+    answerDialog({ app, dialog, accept, promptText, label, location, acted }: DialogAnswering): Operation<void>;
+    resolveDialog(id: number, answer: DialogAnswer): void;
+    resolvePopup(id: number, answer: PopupAnswer): void;
+    /**
+     * Asks the parent to wait for what `request` names, runs `action` meanwhile when one is given, and resolves with what
+     * `wrap` makes of the parent's answer once the action is over and the parent has answered. The wait holds no app, so
+     * the action's own commands go as they would without it; the request goes first, so the parent is waiting before
+     * the action's first command arrives. An action that fails fails the wait with its own failure, and the parent lets go
+     * of what it armed. A wait with an action acts on a page, so it may not run inside the function `expect.poll` calls.
+     */
+    awaitFiles<T>({ label, request, location, timeoutMs }: FilesWaiting, wrap: (answer: Extract<FilesAnswer, {
+        ok: true;
+    }>) => T | Promise<T>, action?: () => unknown): Operation<T>;
+    resolveFiles(id: number, answer: FilesAnswer): void;
+    /**
+     * Asks the parent to change an app's routes, and resolves once the page holds the change, so the test's next command
+     * to the page meets it. It needs the app to itself, as an action does: a request already on its way when the routes
+     * change could meet either. Its time is the action budget, cut to what the test has left. It changes what the page's
+     * requests get, so it may not run inside the function `expect.poll` calls.
+     */
+    changeRoutes({ app, label, request, location }: RouteChange): Operation<void>;
+    resolveRoute(id: number, answer: RouteReply): void;
+    /**
+     * The folder a path a test wrote is read against, as an import's is: that of the file the call came from, or the
+     * test's own file when the call's place is unknown.
+     */
+    callerFolder(location: SourceLocation | undefined): string;
     resolveEvaluation(id: number, answer: EvaluationAnswer): void;
     emit(event: ChildEvent): void;
     countAssertion(): void;
@@ -104,6 +219,17 @@ export declare class TestRun {
      * change. The look is marked as a check's, as `observe` marks its own.
      */
     observePage(app: string, timeoutMs: number, location: SourceLocation | undefined, after?: ObserveAfter): Promise<CommandResult>;
+    /**
+     * Measures an app's page once for a layout assertion: the elements `request` names, and their words when it asks. With
+     * `after`, the page first waits for its next change. The look is marked as a check's, as `observe` marks its own.
+     */
+    observeLayout(app: string, request: LayoutRequest, timeoutMs: number, location: SourceLocation | undefined, after?: ObserveAfter): Promise<CommandResult>;
+    /**
+     * Takes a picture of an app's page, or of one element, for a screenshot assertion, and learns its size and how it
+     * stands against its baseline; the pixels stay with the parent. `previous` names the look before it in the same check,
+     * whose picture this one must match to have settled. The look is marked as a check's, as `observe` marks its own.
+     */
+    observeScreenshot(app: string, request: ScreenshotRequest, previous: string | undefined, timeoutMs: number, location: SourceLocation | undefined): Promise<CommandResult>;
     /**
      * Reads an app's page once outside any check, its address and title, as `page.url()` and `page.title()` do inside
      * `read`. No assertion follows such a look, so it is not marked as a check's.