@quitecode/chromium-automaton 0.1.0-beta.1

package/README.md

@@ -0,0 +1,118 @@
+# Chromium Automaton
+
+[![ci](https://github.com/quitecode9-lab/chromium-automation/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/quitecode9-lab/chromium-automation/actions/workflows/ci.yml)
+
+Chromium Automaton is a lightweight, Chromium-only browser automation library built directly on the Chrome DevTools Protocol (CDP). It offers a Playwright-style API without bundling any runner, fixtures, or reporting.
+
+## What it is
+- A small CDP client with a focused API for Chromium automation
+- A CLI for downloading and caching Chromium snapshots
+- Runner-agnostic assertions you can plug into any test setup
+
+## What it is not
+- Not a framework, runner, or test harness
+- Not multi-browser (Chromium only)
+- Not a report generator (no built-in reporting)
+
+## Install
+
+```bash
+npm install @quitecode/chromium-automaton
+```
+
+## Download Chromium
+
+```bash
+npx chromium-automaton download
+npx chromium-automaton download --latest
+```
+
+## Usage
+
+```ts
+import { chromium, expect } from "@quitecode/chromium-automaton";
+
+const browser = await chromium.launch({ headless: true });
+const page = await browser.newPage();
+
+await page.goto("https://example.com", { waitUntil: "load" });
+await page.click("h1");
+const screenshotBase64 = await page.screenshotBase64();
+
+await expect(page).element("h1").toHaveText(/Example Domain/);
+
+await browser.close();
+```
+
+## Documentation Site
+
+Docs are built with VitePress and published to GitHub Pages:
+https://quitecode9-lab.github.io/chromium-automation/
+
+## Architecture
+
+```mermaid
+graph LR
+  CLI[CLI: chromium-automaton download] --> Downloader[Downloader]
+  Downloader --> Cache[Chromium Cache]
+  User[User Code] --> API[chromium.launch]
+  API --> Manager[ChromiumManager]
+  Manager --> Chromium[Chromium Process]
+  Manager --> Conn[CDP Connection]
+  Conn --> Browser[Browser]
+  Browser --> Page[Page]
+  Page --> Frame[Frame]
+  Page --> Locator[Locator]
+  Page --> Expect[expect]
+```
+
+## Locators
+
+```ts
+const locator = page.locator("#login", { pierceShadowDom: true });
+await locator.click();
+await locator.type("admin");
+```
+
+## Frames
+
+```ts
+const frame = page.frame({ urlIncludes: "embedded" });
+if (frame) {
+  await frame.click("button.submit");
+}
+```
+
+## Shadow DOM
+
+```ts
+await page.click("button.action", { pierceShadowDom: true });
+const text = await page.evaluate(() => document.title);
+```
+
+## Assertions
+
+```ts
+await expect(page).element(".ready").toExist();
+await expect(page).element(".hidden").not.toBeVisible();
+await expect(page).element("h1").toHaveText("Example Domain");
+```
+
+## Environment configuration
+- `CHROMIUM_AUTOMATON_CACHE_DIR`: override cache root
+- `CHROMIUM_AUTOMATON_REVISION`: override pinned revision
+- `CHROMIUM_AUTOMATON_EXECUTABLE_PATH`: bypass download and use this executable
+- `CHROMIUM_AUTOMATON_LOG_LEVEL`: error, warn, info, debug, trace
+
+Default cache root:
+- Linux and macOS: `~/.cache/chromium-automaton`
+- Windows: `%LOCALAPPDATA%\chromium-automaton`
+
+## Limitations
+- Chromium only (no Chrome, Firefox, WebKit)
+- XPath selectors do not pierce shadow DOM
+- `evaluate(string)` is unsafe if the string includes untrusted input
+- Only http/https are allowed in `goto` unless `allowFileUrl` is true
+
+## ESM
+This package is ESM-only. Use `import` syntax in Node 18+.

package/dist/assert/expect.d.ts

@@ -0,0 +1 @@
+export { E as ExpectSelectorOptions, e as expect } from '../expect-CBZIoH1D.js';

package/dist/assert/expect.js

@@ -0,0 +1,7 @@
+import {
+  expect
+} from "../chunk-ADOXZ36A.js";
+export {
+  expect
+};
+//# sourceMappingURL=expect.js.map

package/dist/assert/expect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-ADOXZ36A.js

@@ -0,0 +1,292 @@
+// src/assert/AssertionError.ts
+var AssertionError = class extends Error {
+  selector;
+  timeoutMs;
+  lastState;
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "AssertionError";
+    this.selector = options.selector;
+    this.timeoutMs = options.timeoutMs;
+    this.lastState = options.lastState;
+  }
+};
+
+// src/core/Waiter.ts
+async function waitFor(predicate, options = {}) {
+  const timeoutMs = options.timeoutMs ?? 3e4;
+  const intervalMs = options.intervalMs ?? 100;
+  const start = Date.now();
+  let lastError;
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const result = await predicate();
+      if (result) {
+        return result;
+      }
+    } catch (err) {
+      lastError = err;
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  const description = options.description ? ` (${options.description})` : "";
+  const error = new Error(`Timeout after ${timeoutMs}ms${description}`);
+  error.cause = lastError;
+  throw error;
+}
+
+// src/assert/expect.ts
+var ElementExpectation = class _ElementExpectation {
+  frame;
+  selector;
+  options;
+  negate;
+  events;
+  constructor(frame, selector, options, negate, events) {
+    this.frame = frame;
+    this.selector = selector;
+    this.options = options;
+    this.negate = negate;
+    this.events = events;
+  }
+  get not() {
+    return new _ElementExpectation(this.frame, this.selector, this.options, !this.negate, this.events);
+  }
+  async toExist() {
+    return this.assert(async () => {
+      const exists = await this.frame.exists(this.selector, this.options);
+      return this.negate ? !exists : exists;
+    }, this.negate ? "Expected element not to exist" : "Expected element to exist");
+  }
+  async toBeVisible() {
+    return this.assert(async () => {
+      const visible = await this.frame.isVisible(this.selector, this.options);
+      return this.negate ? !visible : visible;
+    }, this.negate ? "Expected element not to be visible" : "Expected element to be visible");
+  }
+  async toBeHidden() {
+    return this.assert(async () => {
+      const visible = await this.frame.isVisible(this.selector, this.options);
+      return this.negate ? visible : !visible;
+    }, this.negate ? "Expected element not to be hidden" : "Expected element to be hidden");
+  }
+  async toBeEnabled() {
+    return this.assert(async () => {
+      const enabled = await this.frame.isEnabled(this.selector, this.options);
+      if (enabled == null) {
+        return this.negate ? true : false;
+      }
+      return this.negate ? !enabled : enabled;
+    }, this.negate ? "Expected element not to be enabled" : "Expected element to be enabled");
+  }
+  async toBeDisabled() {
+    return this.assert(async () => {
+      const enabled = await this.frame.isEnabled(this.selector, this.options);
+      if (enabled == null) {
+        return this.negate ? true : false;
+      }
+      const disabled = !enabled;
+      return this.negate ? !disabled : disabled;
+    }, this.negate ? "Expected element not to be disabled" : "Expected element to be disabled");
+  }
+  async toBeChecked() {
+    return this.assert(async () => {
+      const checked = await this.frame.isChecked(this.selector, this.options);
+      if (checked == null) {
+        return this.negate ? true : false;
+      }
+      return this.negate ? !checked : checked;
+    }, this.negate ? "Expected element not to be checked" : "Expected element to be checked");
+  }
+  async toBeUnchecked() {
+    return this.assert(async () => {
+      const checked = await this.frame.isChecked(this.selector, this.options);
+      if (checked == null) {
+        return this.negate ? true : false;
+      }
+      const unchecked = !checked;
+      return this.negate ? !unchecked : unchecked;
+    }, this.negate ? "Expected element not to be unchecked" : "Expected element to be unchecked");
+  }
+  async toHaveText(textOrRegex) {
+    const expected = textOrRegex;
+    return this.assert(async () => {
+      const text = await this.frame.text(this.selector, this.options);
+      if (text == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(text) : text.includes(expected);
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element text not to match" : "Expected element text to match", { expected });
+  }
+  async toHaveExactText(textOrRegex) {
+    const expected = textOrRegex;
+    return this.assert(async () => {
+      const text = await this.frame.text(this.selector, this.options);
+      if (text == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(text) : text === expected;
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element text not to match exactly" : "Expected element text to match exactly", { expected });
+  }
+  async toContainText(textOrRegex) {
+    const expected = textOrRegex;
+    return this.assert(async () => {
+      const text = await this.frame.text(this.selector, this.options);
+      if (text == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(text) : text.includes(expected);
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element text not to contain" : "Expected element text to contain", { expected });
+  }
+  async toHaveValue(valueOrRegex) {
+    const expected = valueOrRegex;
+    return this.assert(async () => {
+      const value = await this.frame.value(this.selector, this.options);
+      if (value == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(value) : value === expected;
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element value not to match" : "Expected element value to match", { expected });
+  }
+  async toHaveAttribute(name, valueOrRegex) {
+    const expected = valueOrRegex;
+    return this.assert(async () => {
+      const value = await this.frame.attribute(this.selector, name, this.options);
+      if (expected === void 0) {
+        const exists = value != null;
+        return this.negate ? !exists : exists;
+      }
+      if (value == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(value) : value === expected;
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element attribute not to match" : "Expected element attribute to match", { expected, name });
+  }
+  async toHaveId(idOrRegex) {
+    return this.toHaveAttribute("id", idOrRegex);
+  }
+  async toHaveName(nameOrRegex) {
+    return this.toHaveAttribute("name", nameOrRegex);
+  }
+  async toHaveCount(expected) {
+    return this.assert(async () => {
+      const count = await this.frame.count(this.selector, this.options);
+      const matches = count === expected;
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element count not to match" : "Expected element count to match", { expected });
+  }
+  async toHaveClass(nameOrRegex) {
+    const expected = nameOrRegex;
+    return this.assert(async () => {
+      const classes = await this.frame.classes(this.selector, this.options);
+      if (classes == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected instanceof RegExp ? classes.some((value) => new RegExp(expected.source, expected.flags.replace("g", "")).test(value)) : classes.includes(expected);
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element class not to match" : "Expected element class to match", { expected });
+  }
+  async toHaveClasses(expected) {
+    return this.assert(async () => {
+      const classes = await this.frame.classes(this.selector, this.options);
+      if (classes == null) {
+        return this.negate ? true : false;
+      }
+      const matches = expected.every((value) => classes.includes(value));
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element classes not to match" : "Expected element classes to match", { expected });
+  }
+  async toHaveCss(property, valueOrRegex) {
+    const expected = valueOrRegex;
+    return this.assert(async () => {
+      const value = await this.frame.css(this.selector, property, this.options);
+      if (value == null) {
+        return this.negate ? true : false;
+      }
+      const actual = value.trim();
+      const matches = expected instanceof RegExp ? new RegExp(expected.source, expected.flags.replace("g", "")).test(actual) : actual === expected;
+      return this.negate ? !matches : matches;
+    }, this.negate ? "Expected element css not to match" : "Expected element css to match", { expected, property });
+  }
+  async toHaveFocus() {
+    return this.assert(async () => {
+      const focused = await this.frame.hasFocus(this.selector, this.options);
+      if (focused == null) {
+        return this.negate ? true : false;
+      }
+      return this.negate ? !focused : focused;
+    }, this.negate ? "Expected element not to have focus" : "Expected element to have focus");
+  }
+  async toBeInViewport(options = {}) {
+    return this.assert(async () => {
+      const inViewport = await this.frame.isInViewport(this.selector, this.options, Boolean(options.fully));
+      if (inViewport == null) {
+        return this.negate ? true : false;
+      }
+      return this.negate ? !inViewport : inViewport;
+    }, this.negate ? "Expected element not to be in viewport" : "Expected element to be in viewport");
+  }
+  async toBeEditable() {
+    return this.assert(async () => {
+      const editable = await this.frame.isEditable(this.selector, this.options);
+      if (editable == null) {
+        return this.negate ? true : false;
+      }
+      return this.negate ? !editable : editable;
+    }, this.negate ? "Expected element not to be editable" : "Expected element to be editable");
+  }
+  async assert(predicate, message, details = {}) {
+    const timeoutMs = this.options.timeoutMs ?? 3e4;
+    const start = Date.now();
+    this.events.emit("assertion:start", { name: message, selector: this.selector, frameId: this.frame.id });
+    let lastState;
+    try {
+      await waitFor(async () => {
+        const result = await predicate();
+        lastState = result;
+        return result;
+      }, { timeoutMs, description: message });
+    } catch {
+      const duration2 = Date.now() - start;
+      this.events.emit("assertion:end", { name: message, selector: this.selector, frameId: this.frame.id, durationMs: duration2 });
+      throw new AssertionError(message, { selector: this.selector, timeoutMs, lastState: { lastState, ...details } });
+    }
+    const duration = Date.now() - start;
+    this.events.emit("assertion:end", { name: message, selector: this.selector, frameId: this.frame.id, durationMs: duration });
+  }
+};
+var ExpectFrame = class {
+  frame;
+  events;
+  constructor(frame, events) {
+    this.frame = frame;
+    this.events = events;
+  }
+  element(selector, options = {}) {
+    return new ElementExpectation(this.frame, selector, options, false, this.events);
+  }
+};
+function expect(page) {
+  return {
+    element: (selector, options = {}) => new ElementExpectation(page.mainFrame(), selector, options, false, page.getEvents()),
+    frame: (options) => {
+      const frame = page.frame(options);
+      if (!frame) {
+        throw new AssertionError("Frame not found", { selector: JSON.stringify(options) });
+      }
+      return new ExpectFrame(frame, page.getEvents());
+    }
+  };
+}
+
+export {
+  waitFor,
+  AssertionError,
+  expect
+};
+//# sourceMappingURL=chunk-ADOXZ36A.js.map

package/dist/chunk-ADOXZ36A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/assert/AssertionError.ts","../src/core/Waiter.ts","../src/assert/expect.ts"],"sourcesContent":["export class AssertionError extends Error {\n  selector?: string;\n  timeoutMs?: number;\n  lastState?: unknown;\n\n  constructor(message: string, options: { selector?: string; timeoutMs?: number; lastState?: unknown } = {}) {\n    super(message);\n    this.name = \"AssertionError\";\n    this.selector = options.selector;\n    this.timeoutMs = options.timeoutMs;\n    this.lastState = options.lastState;\n  }\n}\n","export type WaitForOptions = {\n  timeoutMs?: number;\n  intervalMs?: number;\n  description?: string;\n};\n\nexport async function waitFor<T>(predicate: () => Promise<T> | T, options: WaitForOptions = {}): Promise<NonNullable<T>> {\n  const timeoutMs = options.timeoutMs ?? 30_000;\n  const intervalMs = options.intervalMs ?? 100;\n  const start = Date.now();\n\n  let lastError: unknown;\n  while (Date.now() - start < timeoutMs) {\n    try {\n      const result = await predicate();\n      if (result) {\n        return result as NonNullable<T>;\n      }\n    } catch (err) {\n      lastError = err;\n    }\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n\n  const description = options.description ? ` (${options.description})` : \"\";\n  const error = new Error(`Timeout after ${timeoutMs}ms${description}`);\n  (error as Error & { cause?: unknown }).cause = lastError;\n  throw error;\n}\n","import { AssertionError } from \"./AssertionError.js\";\nimport { waitFor } from \"../core/Waiter.js\";\nimport { Page } from \"../core/Page.js\";\nimport { Frame } from \"../core/Frame.js\";\nimport { AutomationEvents } from \"../core/Events.js\";\n\nexport type ExpectSelectorOptions = {\n  timeoutMs?: number;\n  pierceShadowDom?: boolean;\n};\n\nclass ElementExpectation {\n  private frame: Frame;\n  private selector: string;\n  private options: ExpectSelectorOptions;\n  private negate: boolean;\n  private events: AutomationEvents;\n\n  constructor(frame: Frame, selector: string, options: ExpectSelectorOptions, negate: boolean, events: AutomationEvents) {\n    this.frame = frame;\n    this.selector = selector;\n    this.options = options;\n    this.negate = negate;\n    this.events = events;\n  }\n\n  get not() {\n    return new ElementExpectation(this.frame, this.selector, this.options, !this.negate, this.events);\n  }\n\n  async toExist() {\n    return this.assert(async () => {\n      const exists = await this.frame.exists(this.selector, this.options);\n      return this.negate ? !exists : exists;\n    }, this.negate ? \"Expected element not to exist\" : \"Expected element to exist\");\n  }\n\n  async toBeVisible() {\n    return this.assert(async () => {\n      const visible = await this.frame.isVisible(this.selector, this.options);\n      return this.negate ? !visible : visible;\n    }, this.negate ? \"Expected element not to be visible\" : \"Expected element to be visible\");\n  }\n\n  async toBeHidden() {\n    return this.assert(async () => {\n      const visible = await this.frame.isVisible(this.selector, this.options);\n      return this.negate ? visible : !visible;\n    }, this.negate ? \"Expected element not to be hidden\" : \"Expected element to be hidden\");\n  }\n\n  async toBeEnabled() {\n    return this.assert(async () => {\n      const enabled = await this.frame.isEnabled(this.selector, this.options);\n      if (enabled == null) {\n        return this.negate ? true : false;\n      }\n      return this.negate ? !enabled : enabled;\n    }, this.negate ? \"Expected element not to be enabled\" : \"Expected element to be enabled\");\n  }\n\n  async toBeDisabled() {\n    return this.assert(async () => {\n      const enabled = await this.frame.isEnabled(this.selector, this.options);\n      if (enabled == null) {\n        return this.negate ? true : false;\n      }\n      const disabled = !enabled;\n      return this.negate ? !disabled : disabled;\n    }, this.negate ? \"Expected element not to be disabled\" : \"Expected element to be disabled\");\n  }\n\n  async toBeChecked() {\n    return this.assert(async () => {\n      const checked = await this.frame.isChecked(this.selector, this.options);\n      if (checked == null) {\n        return this.negate ? true : false;\n      }\n      return this.negate ? !checked : checked;\n    }, this.negate ? \"Expected element not to be checked\" : \"Expected element to be checked\");\n  }\n\n  async toBeUnchecked() {\n    return this.assert(async () => {\n      const checked = await this.frame.isChecked(this.selector, this.options);\n      if (checked == null) {\n        return this.negate ? true : false;\n      }\n      const unchecked = !checked;\n      return this.negate ? !unchecked : unchecked;\n    }, this.negate ? \"Expected element not to be unchecked\" : \"Expected element to be unchecked\");\n  }\n\n  async toHaveText(textOrRegex: string | RegExp) {\n    const expected = textOrRegex;\n    return this.assert(async () => {\n      const text = await this.frame.text(this.selector, this.options);\n      if (text == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(text)\n        : text.includes(expected);\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element text not to match\" : \"Expected element text to match\", { expected });\n  }\n\n  async toHaveExactText(textOrRegex: string | RegExp) {\n    const expected = textOrRegex;\n    return this.assert(async () => {\n      const text = await this.frame.text(this.selector, this.options);\n      if (text == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(text)\n        : text === expected;\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element text not to match exactly\" : \"Expected element text to match exactly\", { expected });\n  }\n\n  async toContainText(textOrRegex: string | RegExp) {\n    const expected = textOrRegex;\n    return this.assert(async () => {\n      const text = await this.frame.text(this.selector, this.options);\n      if (text == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(text)\n        : text.includes(expected);\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element text not to contain\" : \"Expected element text to contain\", { expected });\n  }\n\n  async toHaveValue(valueOrRegex: string | RegExp) {\n    const expected = valueOrRegex;\n    return this.assert(async () => {\n      const value = await this.frame.value(this.selector, this.options);\n      if (value == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(value)\n        : value === expected;\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element value not to match\" : \"Expected element value to match\", { expected });\n  }\n\n  async toHaveAttribute(name: string, valueOrRegex?: string | RegExp) {\n    const expected = valueOrRegex;\n    return this.assert(async () => {\n      const value = await this.frame.attribute(this.selector, name, this.options);\n      if (expected === undefined) {\n        const exists = value != null;\n        return this.negate ? !exists : exists;\n      }\n      if (value == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(value)\n        : value === expected;\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element attribute not to match\" : \"Expected element attribute to match\", { expected, name });\n  }\n\n  async toHaveId(idOrRegex: string | RegExp) {\n    return this.toHaveAttribute(\"id\", idOrRegex);\n  }\n\n  async toHaveName(nameOrRegex: string | RegExp) {\n    return this.toHaveAttribute(\"name\", nameOrRegex);\n  }\n\n  async toHaveCount(expected: number) {\n    return this.assert(async () => {\n      const count = await this.frame.count(this.selector, this.options);\n      const matches = count === expected;\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element count not to match\" : \"Expected element count to match\", { expected });\n  }\n\n  async toHaveClass(nameOrRegex: string | RegExp) {\n    const expected = nameOrRegex;\n    return this.assert(async () => {\n      const classes = await this.frame.classes(this.selector, this.options);\n      if (classes == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected instanceof RegExp\n        ? classes.some((value) => new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(value))\n        : classes.includes(expected);\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element class not to match\" : \"Expected element class to match\", { expected });\n  }\n\n  async toHaveClasses(expected: string[]) {\n    return this.assert(async () => {\n      const classes = await this.frame.classes(this.selector, this.options);\n      if (classes == null) {\n        return this.negate ? true : false;\n      }\n      const matches = expected.every((value) => classes.includes(value));\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element classes not to match\" : \"Expected element classes to match\", { expected });\n  }\n\n  async toHaveCss(property: string, valueOrRegex: string | RegExp) {\n    const expected = valueOrRegex;\n    return this.assert(async () => {\n      const value = await this.frame.css(this.selector, property, this.options);\n      if (value == null) {\n        return this.negate ? true : false;\n      }\n      const actual = value.trim();\n      const matches = expected instanceof RegExp\n        ? new RegExp(expected.source, expected.flags.replace(\"g\", \"\")).test(actual)\n        : actual === expected;\n      return this.negate ? !matches : matches;\n    }, this.negate ? \"Expected element css not to match\" : \"Expected element css to match\", { expected, property });\n  }\n\n  async toHaveFocus() {\n    return this.assert(async () => {\n      const focused = await this.frame.hasFocus(this.selector, this.options);\n      if (focused == null) {\n        return this.negate ? true : false;\n      }\n      return this.negate ? !focused : focused;\n    }, this.negate ? \"Expected element not to have focus\" : \"Expected element to have focus\");\n  }\n\n  async toBeInViewport(options: { fully?: boolean } = {}) {\n    return this.assert(async () => {\n      const inViewport = await this.frame.isInViewport(this.selector, this.options, Boolean(options.fully));\n      if (inViewport == null) {\n        return this.negate ? true : false;\n      }\n      return this.negate ? !inViewport : inViewport;\n    }, this.negate ? \"Expected element not to be in viewport\" : \"Expected element to be in viewport\");\n  }\n\n  async toBeEditable() {\n    return this.assert(async () => {\n      const editable = await this.frame.isEditable(this.selector, this.options);\n      if (editable == null) {\n        return this.negate ? true : false;\n      }\n      return this.negate ? !editable : editable;\n    }, this.negate ? \"Expected element not to be editable\" : \"Expected element to be editable\");\n  }\n\n  private async assert(predicate: () => Promise<boolean>, message: string, details: Record<string, unknown> = {}) {\n    const timeoutMs = this.options.timeoutMs ?? 30_000;\n    const start = Date.now();\n    this.events.emit(\"assertion:start\", { name: message, selector: this.selector, frameId: this.frame.id });\n\n    let lastState: unknown;\n    try {\n      await waitFor(async () => {\n        const result = await predicate();\n        lastState = result;\n        return result;\n      }, { timeoutMs, description: message });\n    } catch {\n      const duration = Date.now() - start;\n      this.events.emit(\"assertion:end\", { name: message, selector: this.selector, frameId: this.frame.id, durationMs: duration });\n      throw new AssertionError(message, { selector: this.selector, timeoutMs, lastState: { lastState, ...details } });\n    }\n\n    const duration = Date.now() - start;\n    this.events.emit(\"assertion:end\", { name: message, selector: this.selector, frameId: this.frame.id, durationMs: duration });\n  }\n}\n\nclass ExpectFrame {\n  private frame: Frame;\n  private events: AutomationEvents;\n\n  constructor(frame: Frame, events: AutomationEvents) {\n    this.frame = frame;\n    this.events = events;\n  }\n\n  element(selector: string, options: ExpectSelectorOptions = {}) {\n    return new ElementExpectation(this.frame, selector, options, false, this.events);\n  }\n}\n\nexport function expect(page: Page) {\n  return {\n    element: (selector: string, options: ExpectSelectorOptions = {}) => new ElementExpectation(page.mainFrame(), selector, options, false, page.getEvents()),\n    frame: (options: { name?: string; urlIncludes?: string; predicate?: (frame: Frame) => boolean }) => {\n      const frame = page.frame(options);\n      if (!frame) {\n        throw new AssertionError(\"Frame not found\", { selector: JSON.stringify(options) });\n      }\n      return new ExpectFrame(frame, page.getEvents());\n    }\n  };\n}\n"],"mappings":"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","names":["duration"]}