@rehearsal-labs/retest 0.1.0 → 0.3.0

package/dist/browser/contract.d.ts

@@ -11,6 +11,11 @@ import type { TextQuery } from '../protocol/host-check.ts';
 import type { LocatorRecipe } from '../protocol/locator.ts';
 import type { NavigationCause, NavigationDocument, PageFacts } from '../protocol/page-facts.ts';
 import type { StorageState } from '../protocol/storage-state.ts';
+import type { PictureRequest, TakenPicture } from './screenshot.ts';
+import type { DialogArming, DialogReply, UnwaitedDialog } from './dialogs.ts';
+import type { PopupArming, PopupWaitOptions } from './popups.ts';
+import type { RouteRefusal, RouteRemoval } from './routes.ts';
+import type { RouteAnswerRecord, RoutePattern } from '../protocol/routes.ts';
 export type { Emulation } from '../protocol/emulation.ts';
 export type { TextQuery } from '../protocol/host-check.ts';
 /** The kinds of target a session runs on. The first web engine is Chromium; native targets use their own executor. */
@@ -146,13 +151,15 @@ export type ProxyOptions = {
  * anything; without its `userAgent` the page keeps the browser's own. `storageState` is restored before the
  * test's first command: its cookies in the new context, and each origin's `localStorage` before that origin's
  * own scripts run. `proxy` is a setting of the page's new browser context, so every request of the page goes
- * through it.
+ * through it. `downloads` is the absolute folder the context saves the page's downloads in; without it, the browser
+ * refuses every download.
  */
 export type NewPageOptions = {
     baseUrl?: string;
     emulation?: Emulation;
     storageState?: StorageState;
     proxy?: ProxyOptions;
+    downloads?: string;
 };
 /**
  * What `readPage` saw. `url` is the main frame's origin and path as of its latest commit, and `title` the
@@ -203,12 +210,33 @@ export type ResolvedFill = {
     allowedOrigins?: readonly string[];
 };
 /**
- * A page command as the page runs it: every `fill` carries the text to type, and every other command, `select`,
- * `check`, `uncheck` and `scroll` among them, is as the test sent it.
+ * A `goto` whose target is an address. The parent reads a link from an inbox, and checks its origin may open it,
+ * before the page sees the command, so the page never holds a link reference.
+ */
+export type ResolvedGoto = {
+    kind: 'goto';
+    url: string;
+};
+/**
+ * A `setInputFiles`, or a file picker's `setFiles`, whose files are absolute paths on this machine: the parent checks
+ * each path the test gave, and writes a file given by content to a folder of its own, before the page sees the
+ * command. `mimeTypes` holds, by each file's place, the type the test named for a file by content, or null; the page
+ * checks it against the type the browser gives the file. `chooser` is the id the page gave a picker it caught.
+ */
+export type ResolvedInputFiles = Extract<PageCommand, {
+    kind: 'setInputFiles' | 'setChooserFiles';
+}> & {
+    paths: readonly string[];
+    mimeTypes: readonly (string | null)[];
+};
+/**
+ * A page command as the page runs it: every `fill` carries the text to type, every `goto` an address and every
+ * command that gives an input files their paths, and every other command, `select`, `check`, `uncheck` and `scroll`
+ * among them, is as the test sent it.
  */
 export type BrowserCommand = Exclude<PageCommand, {
-    kind: 'fill' | 'swipe' | 'nativeKeyboard' | 'nativeAlert';
-}> | ResolvedFill;
+    kind: 'fill' | 'goto' | 'swipe' | 'nativeKeyboard' | 'nativeAlert' | 'setInputFiles' | 'setChooserFiles' | 'observeScreenshot';
+}> | ResolvedFill | ResolvedGoto | ResolvedInputFiles;
 /**
  * How long `close` waits for a browser's process group to go once it has been killed. A killed process takes a
  * moment to go, so this is the one wait no budget sets: it stands however small the budget is.
@@ -333,6 +361,12 @@ export interface OwnedPage extends NavigationCapability, StorageStateCapability
      */
     execute(command: BrowserCommand, timeoutMs: number, signal?: AbortSignal, commandToken?: number): Promise<CommandResult>;
     screenshot(timeoutMs: number): Promise<Uint8Array>;
+    /**
+     * A picture for a screenshot comparison, a capability of Chromium pages: the viewport, or the one shown element
+     * `request.locator` finds, clipped to its box, with the device scale factor it was taken at, within `timeoutMs`. Sends
+     * no input. Absent on a driver that has only `screenshot`, whose comparisons take the viewport alone.
+     */
+    takePicture?(request: PictureRequest, timeoutMs: number, signal?: AbortSignal): Promise<TakenPicture>;
     /** Disposes the page's browser context. */
     dispose(timeoutMs: number): Promise<void>;
     /**
@@ -343,6 +377,86 @@ export interface OwnedPage extends NavigationCapability, StorageStateCapability
      * on a driver that collects nothing, whose results then say so.
      */
     collectDiagnostics?(sink: DiagnosticSink, timeoutMs: number): Promise<DiagnosticCollection>;
+    /**
+     * Dialogs, a capability of web pages: arms the page, at once, for its next JavaScript dialog, which it then hands to
+     * the test instead of answering it. The wait lasts `timeoutMs`, and `signal` stops it. A page that cannot hand a dialog
+     * over answers `unsupported`, naming its engine; a page without the method has no dialogs to give.
+     */
+    armDialog?(timeoutMs: number, signal?: AbortSignal): DialogArming;
+    /** Answers, within `timeoutMs`, a dialog the page handed to the test: accepted, with a prompt's text, or dismissed. */
+    answerDialog?(id: string, reply: DialogReply, timeoutMs: number): Promise<RequestResult>;
+    /** Hears each dialog the page answered itself because nothing waited for it. Returns a function that stops listening. */
+    onUnwaitedDialog?(listener: (dialog: UnwaitedDialog) => void): () => void;
+    /**
+     * Popups, a capability of Chromium pages: arms the page for the next page it opens, which it hands to the test as a
+     * page of its own, held before its first document. A page that cannot answers `unsupported`, naming its engine.
+     */
+    armPopup?(options: PopupWaitOptions): Promise<PopupArming>;
+    /** File pickers and downloads, a capability of Chromium pages. Absent on a driver that has neither. */
+    readonly files?: FilesCapability | undefined;
+    /**
+     * Mocked responses, a capability of Chromium pages: adds a route, which answers every request of the page whose
+     * address `pattern` matches with `answer` from then on, before every route added earlier, within `timeoutMs`. A popup
+     * shares the routes of the page that opened it. A page that cannot answers `unsupported`, naming where it runs.
+     */
+    addRoute?(pattern: RoutePattern, answer: RouteAnswerRecord, timeoutMs: number): Promise<RequestResult>;
+    /** Removes every route added with `pattern`, within `timeoutMs`, and says how many went. */
+    removeRoute?(pattern: RoutePattern, timeoutMs: number): Promise<RouteRemoval>;
+    /** Tells of each request a route matched whose answer Chrome refused, which the page failed in its place. */
+    onRouteRefused?(listener: (refusal: RouteRefusal) => void): () => void;
+}
+/** A file picker a page caught for a test: the id the page gave it, and whether its input takes several files. */
+export type CaughtChooser = {
+    readonly id: string;
+    readonly multiple: boolean;
+};
+/**
+ * A page armed for the next file picker it opens. `opened` settles once one opens. `release` lets go of the arm when
+ * no picker is wanted any more; a picker that opens after it is one nobody expected.
+ */
+export type ChooserArm = {
+    readonly opened: Promise<CaughtChooser>;
+    release(): void;
+};
+/** How a download ended, as the browser said: the file it saved, or that it stopped, with how many bytes had arrived of how many. */
+export type DownloadEnd = {
+    readonly state: 'completed';
+    readonly filePath: string;
+    readonly receivedBytes: number;
+    readonly totalBytes: number;
+} | {
+    readonly state: 'canceled';
+    readonly receivedBytes: number;
+    readonly totalBytes: number;
+};
+/** Where a download began, when not in the page itself or a frame inside it: a page it opened, or another page. */
+export type DownloadStart = 'popup' | 'other';
+/**
+ * A download a page began, as the browser told it: its id, the address it comes from, the name the browser suggests
+ * for it, where it began when that was not the page itself or a frame inside it, and its end once the browser says it
+ * completed or stopped. `progress` is how many bytes had arrived of how many when the browser last said; a total of 0
+ * means the server gave none.
+ */
+export type PageDownload = {
+    readonly guid: string;
+    readonly url: string;
+    readonly suggestedFilename: string;
+    readonly startedIn?: DownloadStart;
+    readonly ended: Promise<DownloadEnd>;
+    progress(): {
+        readonly receivedBytes: number;
+        readonly totalBytes: number;
+    };
+};
+/**
+ * File pickers and downloads on a page. Every file picker the page opens is caught, and never shown: the one a test
+ * armed for goes to it, and any other fails the action that opened it and is cancelled, as a person closing it would.
+ * `onDownload` tells of every download its browser context makes, from the moment it is added, and returns a function
+ * that removes the listener; it is absent on a page whose browser context refuses downloads.
+ */
+export interface FilesCapability {
+    armFileChooser(): ChooserArm;
+    onDownload?(listener: (download: PageDownload) => void): () => void;
 }
 /**
  * One locator's matches as a keyed read saw them: the observation `observe` answers, and a key for each element it

package/dist/browser/contract.d.ts.map

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

package/dist/browser/dialogs.d.ts

@@ -0,0 +1,157 @@
+import type { CdpSession } from './cdp/session.ts';
+import type { RequestResult } from './contract.ts';
+import type { DialogAnswered, DialogType } from '../protocol/dialogs.ts';
+import type { Failure } from '../protocol/failures.ts';
+/**
+ * A JavaScript dialog as the page showed it: the id the page gave it, its kind, its text and a prompt's default, as the
+ * page wrote them. Both are page text, which the parent redacts before anything records them.
+ */
+export type OpenedDialog = {
+    readonly id: string;
+    readonly type: DialogType;
+    readonly message: string;
+    readonly defaultValue: string;
+};
+/** A wait for the page's next dialog: the dialog, or why none came. */
+export type DialogWait = {
+    readonly ok: true;
+    readonly dialog: OpenedDialog;
+} | {
+    readonly ok: false;
+    readonly failure: Failure;
+};
+/** A page armed for its next dialog, with the wait for it; or why it cannot be armed. */
+export type DialogArming = {
+    readonly ok: true;
+    readonly opened: Promise<DialogWait>;
+} | {
+    readonly ok: false;
+    readonly failure: Failure;
+};
+/** How the test answers a dialog: accepted, with the text a prompt takes, or dismissed. */
+export type DialogReply = {
+    readonly accept: boolean;
+    readonly promptText?: string;
+};
+/**
+ * A dialog Retest answered itself because nothing waited for it, as the page showed it: how Retest answered it, whether
+ * a command was running on the page when it opened, and `popup` when a page this page opened while nothing waited for it
+ * showed it. A command that was running fails with it; a dialog that opened while none was running is the parent's to
+ * report.
+ */
+export type UnwaitedDialog = {
+    readonly type: DialogType;
+    readonly message: string;
+    readonly answered: DialogAnswered;
+    readonly during: boolean;
+    readonly popup?: true;
+};
+/** What dialogs did while a command ran: the first one Retest answered itself, and whether a `beforeunload` kept the page. */
+export type DuringCommand = {
+    readonly unwaited: UnwaitedDialog | undefined;
+    readonly kept: boolean;
+};
+/** A dialog that closed: its kind, and whether it was accepted. */
+export type ClosedDialog = {
+    readonly type: DialogType;
+    readonly accepted: boolean;
+};
+/**
+ * The JavaScript dialogs of one Chromium page. A dialog holds the page until it is answered: the command whose input
+ * opened it waits, as Chrome does not answer that input before then. A page armed with `arm` hands its next dialog to
+ * the test, which answers it with `answer`. Any other dialog Retest answers at once, dismissing it, or accepting a
+ * `beforeunload` so the navigation the test asked for happens, and tells its listeners; a command running meanwhile
+ * fails with it, so no dialog is ever answered silently as a pass.
+ */
+export declare class PageDialogs {
+    #private;
+    constructor(session: CdpSession, onListenerError: (error: unknown) => void);
+    /** The kind of the dialog open on the page, while one is. */
+    get open(): DialogType | undefined;
+    /** The dialog the test was given and has not answered, which holds the page until it does. */
+    get held(): OpenedDialog | undefined;
+    /**
+     * Arms the page for its next dialog, at once, so a command sent after this call cannot open a dialog Retest would
+     * answer itself. The wait settles with that dialog, or fails when `timeoutMs` runs out, when `signal` aborts, with its
+     * reason when that is a `Failure`, or when the page goes. One wait at a time.
+     */
+    arm(timeoutMs: number, signal?: AbortSignal): DialogArming;
+    /**
+     * Answers the dialog the test was given, accepting it with a prompt's text or dismissing it, within `timeoutMs`.
+     * A dialog that is no longer open, or one the test was not given, fails and nothing is sent.
+     */
+    answer(id: string, reply: DialogReply, timeoutMs: number): Promise<RequestResult>;
+    /**
+     * Takes on the dialogs Retest answered on the page before the page was set up, as an Electron app's first window can
+     * show one as it loads. Listeners hear them first, as dialogs nothing waited for that opened while no command ran.
+     */
+    answeredBefore(dialogs: readonly UnwaitedDialog[]): void;
+    /**
+     * Hears each dialog Retest answered itself, those before the call first, since a popup runs before whoever waits for
+     * it can listen. Returns a function that stops listening.
+     */
+    onUnwaited(listener: (dialog: UnwaitedDialog) => void): () => void;
+    /**
+     * Tells of a dialog Retest answered in a page this page opened while nothing waited for it, as this page's own: a
+     * command running here fails with it, and the listeners hear it.
+     */
+    forward(dialog: UnwaitedDialog): void;
+    /** Hears each dialog that closed, however it was answered. Returns a function that stops listening. */
+    onClosed(listener: (dialog: ClosedDialog) => void): () => void;
+    /**
+     * Marks a command running on the page. The function it returns marks it over, and says what dialogs did meanwhile:
+     * the first Retest answered itself, which the command then fails with, and whether a `beforeunload` dialog was
+     * dismissed, which kept the page where it was.
+     */
+    commandStarted(): () => DuringCommand;
+    /** Reads `Page.javascriptDialogOpening`: hands the dialog to the test that waits for it, or answers it at once. */
+    opened(params: unknown): void;
+    /** Reads `Page.javascriptDialogClosed`. */
+    closed(params: unknown): void;
+    /** The page went away: a wait fails with the reason, and no dialog is open any more. */
+    lost(reason: string): void;
+}
+/**
+ * The failure of a command during which the page opened a dialog nothing waited for, which Retest answered. `command`
+ * is the command as a failure names it. The dialog's text is page text: it goes in `details.dialogMessage`, as the page
+ * showed it, for the parent to redact and quote, and the message leaves it out.
+ *
+ * @example unwaitedDialogFailure("click getByTestId('delete')", dialog, true).class // 'not_actionable'
+ */
+export declare function unwaitedDialogFailure(command: string, dialog: UnwaitedDialog, inputSent: boolean): Failure;
+/**
+ * A command's own failure, with the dialog Retest answered while it ran named after it: the command's class, message
+ * and details stay first, since its outcome is what happened, and the dialog follows in a sentence of its own and in
+ * `details`. The dialog's text goes in `details.dialogMessage` for the parent to redact and quote.
+ *
+ * @example withUnwaitedDialog(timedOut, dialog).class // 'timeout'
+ */
+export declare function withUnwaitedDialog(failure: Failure, dialog: UnwaitedDialog): Failure;
+/**
+ * The failure of a command the page did not follow because a `beforeunload` dialog was dismissed, which keeps the page
+ * where it was.
+ *
+ * @example keptByBeforeunload('open http://127.0.0.1:4173/next', true).class // 'not_actionable'
+ */
+export declare function keptByBeforeunload(command: string, inputSent: boolean): Failure;
+/**
+ * A command's own failure of another kind, as a timeout, while a `beforeunload` dialog the test dismissed kept the page:
+ * its class and message stay first, and the kept page follows.
+ *
+ * @example withKeptPage(timedOut).message.endsWith('so the page stayed where it was.') // true
+ */
+export declare function withKeptPage(failure: Failure): Failure;
+/**
+ * The failure of a command that met a dialog the test was given and has not answered, which holds the page: one sent
+ * while it holds the page, which sends nothing, or the command whose input opened it and whose time ran out waiting.
+ *
+ * @example heldByDialog("click getByTestId('save')", 'confirm', false).class // 'not_actionable'
+ */
+export declare function heldByDialog(command: string, type: DialogType, inputSent: boolean): Failure;
+/**
+ * The refusal of `page.dialog()` on a page of an engine that cannot hand its dialogs to a test yet.
+ *
+ * @example dialogsUnsupported('Firefox').class // 'unsupported'
+ */
+export declare function dialogsUnsupported(engine: string): Failure;
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/browser/dialogs.d.ts.map

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