@unotest/web 0.45.0 → 0.47.0

package/dist/inspection/page-inject.d.ts

@@ -1,6 +1,6 @@
 import { InjectedDomHelpers } from '@unotest/grounder-client/dom-walker';
 import { PickerMode } from '@unotest/protocol';
-import { E as ElementHint } from '../interfaces-OvnJKELk.js';
+import { E as ElementHint } from '../interfaces-LE6GsJ0c.js';
 import '../config/schema.js';
 import 'zod';
 
@@ -426,6 +426,14 @@ declare function readCheckedState(el: Element): boolean | null;
 /** Disabled state — native `:disabled` (covers `<fieldset disabled>`
  *  inheritance) or `aria-disabled` on a custom widget. */
 declare function readDisabledState(el: Element): boolean;
+/** Computed value of one CSS property — custom properties included, which
+ *  `getPropertyValue` returns with the whitespace after their colon. */
+declare function readComputedStyle(el: Element, property: string): string;
+/** How many animations of the element and its descendants are still
+ *  playing towards an end. An infinite one (a spinner) never ends, so it
+ *  is not counted — waiting for it could only time out; neither is a
+ *  paused one, which ends only when the page resumes it. */
+declare function countRunningAnimations(el: Element): number;
 /** Write a localStorage item. Key and value travel as one array because
  *  Playwright's `evaluate(fn, arg)` passes a SINGLE argument. */
 declare function writeLocalStorageItem([key, value]: [string, string]): void;
@@ -441,4 +449,4 @@ declare function inspectElementRaw(el: Element, args: {
     };
 }): ElementHintRaw;
 
-export { type ElementHintRaw, ariaSnapshotAlgorithm, findElementAlgorithm, inspectElementRaw, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readDisabledState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };
+export { type ElementHintRaw, ariaSnapshotAlgorithm, countRunningAnimations, findElementAlgorithm, inspectElementRaw, outlineAlgorithm, pasteValue, pickerOverlayAlgorithm, readCheckedState, readComputedStyle, readDisabledState, readLocalStorageItem, semanticDomAlgorithm, serializeRuntimeDom, writeLocalStorageItem };

package/dist/inspection/page-inject.js

@@ -2791,6 +2791,16 @@ function readDisabledState(el) {
   return el.matches(":disabled") || el.getAttribute("aria-disabled") === "true";
 }
 __name(readDisabledState, "readDisabledState");
+function readComputedStyle(el, property) {
+  globalThis.__name ??= (fn) => fn;
+  return getComputedStyle(el).getPropertyValue(property).trim();
+}
+__name(readComputedStyle, "readComputedStyle");
+function countRunningAnimations(el) {
+  globalThis.__name ??= (fn) => fn;
+  return el.getAnimations({ subtree: true }).filter((a) => a.playState === "running" && a.effect?.getComputedTiming().iterations !== Infinity).length;
+}
+__name(countRunningAnimations, "countRunningAnimations");
 function writeLocalStorageItem([key, value]) {
   globalThis.__name ??= (fn) => fn;
   localStorage.setItem(key, value);
@@ -3000,12 +3010,14 @@ function inspectElementRaw(el, args) {
 __name(inspectElementRaw, "inspectElementRaw");
 export {
   ariaSnapshotAlgorithm,
+  countRunningAnimations,
   findElementAlgorithm,
   inspectElementRaw,
   outlineAlgorithm,
   pasteValue,
   pickerOverlayAlgorithm,
   readCheckedState,
+  readComputedStyle,
   readDisabledState,
   readLocalStorageItem,
   semanticDomAlgorithm,

package/dist/{interfaces-OvnJKELk.d.ts → interfaces-LE6GsJ0c.d.ts}

@@ -88,6 +88,10 @@ interface LaunchOptions {
      *  persistent context, which every `newContext()` then returns
      *  (`config.launch.userDataDir`). */
     userDataDir?: string;
+    /** A new browser on a new profile directory for every context
+     *  (`config.launch.profile`); each `newContext()` then needs
+     *  `ContextOptions.profileDir`. */
+    profile?: "per-test";
     /** Extra browser command-line arguments (`config.launch.args`). */
     args?: string[];
 }
@@ -139,6 +143,10 @@ interface ContextOptions {
      * `UNOTEST_DEFAULT_NAVIGATION_TIMEOUT_MS` env overrides.
      */
     defaultNavigationTimeoutMs?: number;
+    /** The directory a `profile: "per-test"` browser starts on. The caller
+     *  makes it and decides whether it stays; given to any other launch it
+     *  is refused. */
+    profileDir?: string;
 }
 interface ActionTimeout {
     /** Override default action timeout (D-7 actionability wait). Milliseconds. */
@@ -324,6 +332,11 @@ interface WebDriver {
     wsEndpoint(): string | undefined;
     connectShared(wsEndpoint: string, browser: LaunchOptions["browser"]): Promise<void>;
     attachExisting(opts?: AttachOptions): Promise<DriverContext>;
+    /** True while the browser `connectShared` joined is still there. A run
+     *  on `launch.profile: "per-test"` closes it with each test and starts
+     *  the next one at the same endpoint, so a joined client asks this
+     *  before it follows the run. False when nothing is joined. */
+    sharedBrowserConnected(): boolean;
 }
 /** One captured network request/response, recorded only under
  *  `UNOTEST_NETWORK`. `status`/`ok` come from the response; `failureText`
@@ -361,6 +374,11 @@ interface DownloadNameFilter {
 }
 /** A fake clock shared by every page of a context. Time runs by itself
  *  until `freeze`, and again after `run`. */
+/** Media features a page can be made to report — Playwright's values. */
+interface EmulatedMedia {
+    reducedMotion?: "reduce" | "no-preference";
+    colorScheme?: "light" | "dark" | "no-preference";
+}
 interface DriverClock {
     /** Stop time at `at`: `Date` reads it, and no timer fires until `tick`
      *  or `run`. Any instant, past or future — no timer fires on the way. */
@@ -545,10 +563,16 @@ interface DriverContext {
      * runner can pull the tail when a test fails.
      */
     consoleEntries(): ReadonlyArray<{
-        level: "log" | "info" | "warn" | "error" | "debug";
+        level: ConsoleLevel;
         text: string;
         timestamp: string;
     }>;
+    /** The console lines and uncaught errors of the ACTIVE page, oldest
+     *  first. Recorded always, from the moment the page opened — unlike
+     *  `consoleEntries()`, which only `UNOTEST_CONSOLE` fills — so a
+     *  scenario that clicks and then asks finds what the click logged.
+     *  Extension pages (`chrome-extension://`) are pages like any other. */
+    pageConsole(): PageConsole;
     /**
      * Snapshot of network request/response entries captured since context
      * creation, oldest first. Populated only when `UNOTEST_NETWORK` is on (else
@@ -618,11 +642,27 @@ interface DriverPage {
     isDisabled(loc: LocatorValue): Promise<boolean>;
     /** Read a DOM attribute on the matched element. Returns null if absent. */
     getAttribute(loc: LocatorValue, name: string): Promise<string | null>;
+    /** The matched element's computed value of a CSS property, as
+     *  `getComputedStyle(el).getPropertyValue(property)` gives it — custom
+     *  properties (`--accent`) included; "" for one that is not set. */
+    computedStyle(loc: LocatorValue, property: string): Promise<string>;
     /** Wait for a DOM-presence state (`attached`/`detached`/`visible`/
      *  `hidden`) or an interaction state (`enabled`/`disabled`). The latter
      *  is polled against `isDisabled`, so `aria-disabled` widgets count. */
     waitFor(loc: LocatorValue, opts?: WaitForOptions): Promise<void>;
-    waitForUrl(pattern: string | RegExp, opts?: NavigationOptions): Promise<void>;
+    /** How many finite animations of the matched element and its
+     *  descendants are still running. Infinite ones (spinners) and paused
+     *  ones are not counted: neither is going to end by itself. */
+    runningAnimations(loc: LocatorValue): Promise<number>;
+    /** Wait until `runningAnimations(loc)` is 0. Times out with a
+     *  `TimeoutError` naming the locator and how many were left. */
+    waitForAnimations(loc: LocatorValue, timeoutMs: number): Promise<void>;
+    /** A string matches as a substring of the URL, a regex unanchored. */
+    waitForUrl(pattern: Matcher, opts?: NavigationOptions): Promise<void>;
+    /** Change the media features this page reports, from now on: what
+     *  `matchMedia` and CSS `@media` see. A feature left out keeps its
+     *  current value. This page only — a tab opened later starts without it. */
+    emulateMedia(media: EmulatedMedia): Promise<void>;
     /** Wait until ≥1 VISIBLE occurrence of `text` matches (or none, with
      *  `state: 'hidden' | 'detached'`). Accepts a regex matcher in the
      *  JSON-safe `Matcher` shape. */
@@ -787,5 +827,26 @@ interface AncestorHint {
     /** A single stable, semantic class token (not a hash / utility class). */
     className?: string;
 }
+type ConsoleLevel = "log" | "info" | "warn" | "error" | "debug";
+/** One console line of a page: `url` is the page's at the time, `at`
+ *  epoch ms — the scale `nowMs()` gives a scenario. */
+interface PageConsoleEntry {
+    level: ConsoleLevel;
+    text: string;
+    url: string;
+    at: number;
+}
+/** An error the page threw and nothing caught (`pageerror`). `stack` is
+ *  empty when the browser gave none. */
+interface PageErrorEntry {
+    message: string;
+    stack: string;
+    url: string;
+    at: number;
+}
+interface PageConsole {
+    entries: readonly PageConsoleEntry[];
+    errors: readonly PageErrorEntry[];
+}
 
-export { type AttachOptions as A, type BoundingBox as B, type CaptureFrame as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type LocatorValue as L, type NetworkEntry as N, type PressOptions as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type CaptureRect as a, type LaunchOptions as b, type ContextOptions as c, type ActionTimeout as d, type CheckOptions as e, type ClickOptions as f, type CookieOptions as g, type DriverPage as h, type NavigationOptions as i, type SelectOptions as j, type ViewportSize as k, type WaitOptions as l, type WaitState as m, type DriverDownload as n, type LocatorStep as o, appendStep as p, describeLocator as q, isLocatorValue as r, rootedAt as s };
+export { type AttachOptions as A, type BoundingBox as B, type CaptureFrame as C, type DriverContext as D, type ElementHint as E, type FillOptions as F, type GotoOptions as G, type HoverOptions as H, type LocatorValue as L, type NetworkEntry as N, type PageConsole as P, type ReloadOptions as R, type ScreenshotOptions as S, type Viewport as V, type WebDriver as W, type CaptureRect as a, type LaunchOptions as b, type ContextOptions as c, type ActionTimeout as d, type CheckOptions as e, type ClickOptions as f, type CookieOptions as g, type DriverPage as h, type NavigationOptions as i, type PressOptions as j, type SelectOptions as k, type ViewportSize as l, type WaitOptions as m, type WaitState as n, type DriverDownload as o, type LocatorStep as p, appendStep as q, describeLocator as r, isLocatorValue as s, rootedAt as t };