@rehearsal-labs/retest 0.1.0 → 0.3.0

package/dist/api/inbox.js

@@ -0,0 +1,191 @@
+import { inspect } from 'node:util';
+import { describeInboxReference } from "../protocol/inbox.js";
+import { patternProblem, textPatternOf } from "../protocol/locator.js";
+import { isPlainObject } from "../protocol/schema.js";
+import { maxTimeout } from "../protocol/timeouts.js";
+import { requireScope } from "./context.js";
+import { formatValue } from "./format-value.js";
+import { misuse } from "./misuse.js";
+import { Secret } from "./secret.js";
+let codeReference;
+let linkReference;
+/**
+ * A one-time code from a message, named but never held: the process that runs Retest types it, bound to origins as a
+ * secret is. It is a secret, so it goes only to `fill()`, and however it is printed it reads `{{code}}`.
+ */
+export class InboxCode extends Secret {
+    #reference;
+    static {
+        codeReference = (code) => code.#reference;
+    }
+    constructor(reference) {
+        super('code');
+        this.#reference = reference;
+    }
+}
+/**
+ * A link from a message, named but never held: the process that runs Retest opens it, when its origin is one the test
+ * may open. It goes only to `goto()`, and however it is printed it reads `{{link}}`, or `{{link:2}}` when it was chosen
+ * by number or path.
+ */
+export class InboxLink {
+    #reference;
+    static {
+        linkReference = (link) => link.#reference;
+        // Node's inspect hook sits on the prototype, off the declared type, so the public type needs no Node types.
+        Object.defineProperty(InboxLink.prototype, inspect.custom, {
+            value() {
+                return this.toString();
+            },
+        });
+    }
+    constructor(reference) {
+        this.#reference = reference;
+    }
+    toString() {
+        return describeInboxReference(this.#reference);
+    }
+    toJSON() {
+        return this.toString();
+    }
+}
+/**
+ * A message an inbox gave the test. `subject`, `from` and `text` have each code written `{{code}}` and each link that
+ * carries a token written `{{link:1}}`, `{{link:2}}` and so on, by its number. `code` is its first code, for `fill()`,
+ * and `link()` one of its links, for `goto()`; the test's process never holds either value.
+ */
+export class ReceivedMessage {
+    subject;
+    from;
+    text;
+    /** When the mailbox received it. */
+    receivedAt;
+    links;
+    /** The message's first code. A fill of it fails when the message holds none. */
+    code;
+    #record;
+    constructor(record) {
+        this.#record = record;
+        this.subject = record.subject;
+        this.from = record.from;
+        this.text = record.text;
+        this.receivedAt = new Date(record.receivedAt);
+        this.links = Object.freeze(record.links.map((link) => Object.freeze({ ...link })));
+        this.code = new InboxCode({ inbox: record.inbox, message: record.id, code: 1 });
+    }
+    /**
+     * One of the message's links, for `goto()`. With no argument, the first link that carries a token, or else the first
+     * link. A number takes that link, from 1; `{ path }` the first link whose path is `path` or lies under it.
+     *
+     * @example await page.goto(message.link({ path: '/verify' }))
+     */
+    link(choice) {
+        const { inbox, id } = this.#record;
+        const chosen = this.#choose(choice);
+        if (typeof chosen === 'string')
+            throw misuse(chosen);
+        return new InboxLink({ inbox, message: id, link: chosen, ...(choice === undefined ? { default: true } : {}) });
+    }
+    // A link's number from 1, or why there is none to take.
+    #choose(choice) {
+        const { links } = this;
+        const subject = JSON.stringify(this.subject);
+        if (choice === undefined) {
+            if (links.length === 0)
+                return `link() found no link in the message ${subject}.`;
+            const carrying = links.findIndex((link) => link.token);
+            return (carrying === -1 ? 0 : carrying) + 1;
+        }
+        if (typeof choice === 'number') {
+            if (Number.isInteger(choice) && choice >= 1 && choice <= links.length)
+                return choice;
+            return `link(${formatValue(choice)}) takes a link's number from 1 to ${links.length}, the links of the message ${subject}.`;
+        }
+        if (isPlainObject(choice) && Object.keys(choice).length === 1 && typeof choice['path'] === 'string') {
+            const path = choice['path'];
+            const under = path.endsWith('/') ? path : `${path}/`;
+            const found = links.findIndex((link) => link.path === path || link.path.startsWith(under));
+            if (found !== -1)
+                return found + 1;
+            const paths = links.map((link) => link.path).filter((each) => each !== '');
+            const listed = paths.length === 0 ? 'Its links have no web address.' : `Its links go to ${paths.join(', ')}.`;
+            return `link({ path: ${JSON.stringify(path)} }) matches no link in the message ${subject}. ${listed}`;
+        }
+        return `link() takes a link's number from 1, such as link(2), or its path, such as link({ path: '/verify' }), received ${formatValue(choice)}.`;
+    }
+}
+/** A test mailbox from the config, named for the reads a test makes of it. */
+export class Inbox {
+    #name;
+    constructor(name) {
+        this.#name = name;
+    }
+    /** The inbox's name in the config. */
+    get name() {
+        return this.#name;
+    }
+    /**
+     * Waits for the newest message the mailbox received since the test started, or since the last message this test was
+     * given from it, and gives it to the test. It looks again, as a matcher does, until one arrives or its time runs out.
+     *
+     * @example const message = await inbox('owner').latest({ subject: 'Your sign-in code' })
+     */
+    latest(options) {
+        const call = `inbox(${JSON.stringify(this.#name)}).latest()`;
+        const { run } = requireScope(call);
+        const location = run.location();
+        const read = readOptions(options);
+        if (typeof read === 'string')
+            throw misuse(`${call} ${read}`, run);
+        const request = { inbox: this.#name, ...(read.subject === undefined ? {} : { subject: read.subject }) };
+        return run.readInbox({ label: call, request, location, ...(read.timeoutMs === undefined ? {} : { timeoutMs: read.timeoutMs }) }, (record) => new ReceivedMessage(record));
+    }
+}
+/**
+ * Names an inbox from the config, whose messages a test reads with `latest()`. The test's process never holds a code or
+ * a link that carries a token.
+ *
+ * @example
+ * const message = await inbox('owner').latest({ subject: 'Your sign-in code' })
+ * await page.getByLabel('Code').fill(message.code)
+ */
+export function inbox(name) {
+    // Read as JavaScript passed it: a registered config narrows the type, not what arrives.
+    const given = name;
+    if (typeof given !== 'string' || given === '')
+        throw misuse(`inbox() takes the name of an inbox from the config, received ${formatValue(given)}.`);
+    return new Inbox(given);
+}
+/** The code a value names, when it is a code from an inbox. */
+export function inboxCodeReference(value) {
+    return value instanceof InboxCode ? codeReference?.(value) : undefined;
+}
+/** The link a value names, when it is a link from an inbox. */
+export function inboxLinkReference(value) {
+    return value instanceof InboxLink ? linkReference?.(value) : undefined;
+}
+// Every option is checked, because JavaScript callers have no types. A key set to undefined counts as absent.
+function readOptions(options) {
+    if (options === undefined)
+        return {};
+    if (!isPlainObject(options))
+        return `takes options such as { subject: 'Your code', timeout: 10_000 }, received ${formatValue(options)}.`;
+    const given = Object.entries(options).filter(([, value]) => value !== undefined);
+    const unknown = given.find(([key]) => key !== 'subject' && key !== 'timeout');
+    if (unknown !== undefined)
+        return `has no option ${JSON.stringify(unknown[0])}. It takes subject and timeout.`;
+    const { subject, timeout } = Object.fromEntries(given);
+    if (timeout !== undefined && !(typeof timeout === 'number' && Number.isInteger(timeout) && timeout >= 1 && timeout <= maxTimeout)) {
+        return `takes timeout as a whole number of milliseconds from 1 to ${maxTimeout}, received ${formatValue(timeout)}.`;
+    }
+    const timed = timeout === undefined ? {} : { timeoutMs: timeout };
+    if (subject === undefined)
+        return timed;
+    if (typeof subject === 'string')
+        return subject === '' ? 'takes subject as text to find in the subject, received an empty string.' : { subject, ...timed };
+    if (!(subject instanceof RegExp))
+        return `takes subject as text or a RegExp, received ${formatValue(subject)}.`;
+    const pattern = textPatternOf(subject);
+    const problem = patternProblem(pattern);
+    return problem === undefined ? { subject: pattern, ...timed } : `received a subject RegExp Retest cannot read: ${problem}.`;
+}

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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAA;AAE/G,yHAAyH;AACzH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAA;AAElE;;;GAGG;AACH,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO;IACtD;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5C;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAChE;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACxE;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACvE;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9E;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,IAAI,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,KAAK,CAAC;IAC3E;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACtB;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG;IACrD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,6EAA6E,CAAC,CAAA;CAC9G,CAAA;AAED,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzF;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,KAAK,CAAC;IAC9E;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;IACvB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAA;IACtB;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAClC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxF;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5F;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,6DAA6D,CAAC,CAAA;CAC7J;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAAE,GAC/K;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAAE,CAAA;AAEvJ,sHAAsH;AACtH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtD,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE7D,0FAA0F;AAC1F,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,cAAc;IAC5D,WAAW,CAAC,EAAE,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACrD,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACzE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IACjF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IAChF;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;CAC1D;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,QAAQ;IAChG;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,uCAAuC,CAAC,CAAA;IACrJ;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,uCAAuC,CAAC,CAAA;IACxJ;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,uCAAuC,CAAC,CAAA;CACrK;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9D;AAED,iGAAiG;AACjG,MAAM,WAAW,UAAU,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAC3G,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,sDAAsD,CAAC,CAAA;IACtF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAC3C,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,2CAA2C,CAAC,CAAA;CACtL;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAC9G,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;IAChC,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC/B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC3C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxF,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,2CAA2C,CAAC,CAAA;IACrL,QAAQ,CAAC,GAAG,EAAE,QAAQ,SAAS,eAAe,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,+CAA+C,CAAC,CAAA;IAC5J,QAAQ,CAAC,KAAK,EAAE,QAAQ,SAAS,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,mCAAmC,CAAC,CAAA;IAC1I,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,+DAA+D,CAAC,CAAA;IACjG,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,qEAAqE,CAAC,CAAA;IACtG,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,uEAAuE,CAAC,CAAA;CAC3G;AAED,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA"}
+{"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"}