@e2e-dev/web 0.11.0 → 0.11.2

package/dist/.build.json

@@ -1 +1 @@
-{"version":"0.11.0"}
+{"version":"0.11.2"}

package/dist/actions.d.ts

@@ -20,4 +20,3 @@ export declare function dispatchPointerAction(page: Page, at: ViewportPoint, act
  * committed, or an engine fault.
  */
 export declare function classifyActionError(rawCause: unknown, action: LocatorAction): Error;
-//# sourceMappingURL=actions.d.ts.map

package/dist/actions.js

@@ -191,4 +191,3 @@ export function classifyActionError(rawCause, action) {
     }
     return new EngineError('ENGINE_FAILURE', text, { retryable: false, cause });
 }
-//# sourceMappingURL=actions.js.map

package/dist/attempt-session.d.ts

@@ -109,4 +109,3 @@ export declare class AttemptSession {
     private finalize;
 }
 export {};
-//# sourceMappingURL=attempt-session.d.ts.map

package/dist/attempt-session.js

@@ -345,4 +345,3 @@ export class AttemptSession {
         }
     }
 }
-//# sourceMappingURL=attempt-session.js.map

package/dist/browser-connection.d.ts

@@ -31,4 +31,3 @@ export declare function browserType(name: BrowserName): typeof chromium;
  * detaches the CDP session without killing the remote process the host owns.
  */
 export declare function connectCdp(endpoint: string, timeoutMs: number): Promise<Browser>;
-//# sourceMappingURL=browser-connection.d.ts.map

package/dist/browser-connection.js

@@ -94,4 +94,3 @@ function registerSelectorEngines() {
     selectorEngines ??= Promise.all(SELECTOR_ENGINES.map(({ name, source }) => selectors.register(name, new Function(`return ${source};`)()))).then(() => undefined);
     return selectorEngines;
 }
-//# sourceMappingURL=browser-connection.js.map

package/dist/browser.d.ts

@@ -197,4 +197,3 @@ export interface Browser extends Expectable<BrowserExpectation> {
 }
 /** Builds the `browser` fixture for one attempt over the shared surface. */
 export declare function createBrowserFixture(surface: PlaywrightSurface, context: EngineFixtureContext): Browser;
-//# sourceMappingURL=browser.d.ts.map

package/dist/browser.js

@@ -11,7 +11,7 @@
  * never re-implemented here: `context.app.resolveUrl` is the one place that
  * says which URLs a test may open.
  */
-import { Deadline, describePattern, EngineError, matchesText, pollCondition, TestError, toTextPattern, urlMatches, validateJsonValue, } from 'e2e/engine';
+import { Deadline, describePattern, EngineError, matchesText, pollCondition, rejectUnknownOptions, TestError, toTextPattern, urlMatches, validateJsonValue, } from 'e2e/engine';
 import { saveDownloadsTo, saveFromBrowser, saveLocally } from './downloads.js';
 import { isTestErrorCode, message as causeMessage, translatePwError } from './support.js';
 import { compileEvaluation } from './evaluation.js';
@@ -85,7 +85,10 @@ export function createBrowserFixture(surface, context) {
         url: currentUrl,
         title: currentTitle,
         // The same poll as `expect(browser).toHaveURL`, exposed as a wait.
-        waitForURL: (url, options) => expectation.toHaveURL(url, options),
+        waitForURL: (url, options) => {
+            rejectUnknownOptions('browser.waitForURL', options, ['timeout']);
+            return expectation.toHaveURL(url, options);
+        },
         locator: (selector) => context.locator({ kind: 'selector', selector: requireSelector('browser.locator', selector) }),
         frameLocator: (selector) => frameScreen(context, [requireSelector('browser.frameLocator', selector)]),
         async evaluate(fn, arg) {
@@ -333,20 +336,24 @@ function createBrowserExpectation(deps, negated = false) {
             onTimeout: async () => new TestError('ASSERTION_FAILED', `expect.${negated ? 'not.' : ''}${api} failed\nexpected: ${negated ? 'not ' : ''}${label}\nobserved: ${await observed()}`),
         });
     };
+    const validate = (api, options) => rejectUnknownOptions(`expect.${negated ? 'not.' : ''}${api}`, options, ['timeout']);
     return {
         get not() {
             return createBrowserExpectation(deps, !negated);
         },
         toHaveURL(expected, options) {
+            validate('toHaveURL', options);
             const label = typeof expected === 'string' ? expected : String(expected);
             const target = deps.baseHref();
             return poll('toHaveURL', `URL ${label}`, async () => urlMatches(await deps.currentUrl(), expected, target), async () => `URL ${await deps.currentUrl()}`, options?.timeout);
         },
         toHaveTitle(expected, options) {
+            validate('toHaveTitle', options);
             const pattern = toTextPattern(expected, { exact: true });
             return poll('toHaveTitle', `title ${describePattern(pattern)}`, async () => matchesText(await deps.currentTitle(), pattern), async () => `title ${JSON.stringify(await deps.currentTitle())}`, options?.timeout);
         },
         toHaveClass(target, expected, options) {
+            validate('toHaveClass', options);
             const pattern = toTextPattern(expected, { exact: true });
             return poll('toHaveClass', `class ${describePattern(pattern)}`, async () => {
                 try {
@@ -395,4 +402,3 @@ function frameScreen(context, frames) {
         frameLocator: (selector) => frameScreen(context, [...frames, requireSelector('frameLocator', selector)]),
     });
 }
-//# sourceMappingURL=browser.js.map

package/dist/capture-scope.d.ts

@@ -18,4 +18,3 @@ export declare class CaptureScope {
     /** Refuses further work after cancellation, expiry, or completion. */
     check(): void;
 }
-//# sourceMappingURL=capture-scope.d.ts.map

package/dist/capture-scope.js

@@ -58,4 +58,3 @@ export class CaptureScope {
 function captureTimeout() {
     return new EngineError('OPERATION_TIMEOUT', 'observation capture timed out', { retryable: false });
 }
-//# sourceMappingURL=capture-scope.js.map

package/dist/cdp-recovery.d.ts

@@ -26,4 +26,3 @@ export declare function attachPersistent(resolve: CdpEndpointResolver, budget: C
     readonly identity: PersistentIdentity;
 }>;
 export {};
-//# sourceMappingURL=cdp-recovery.d.ts.map

package/dist/cdp-recovery.js

@@ -81,4 +81,3 @@ export async function attachPersistent(resolve, budget, previous) {
         signal.removeEventListener('abort', detach);
     }
 }
-//# sourceMappingURL=cdp-recovery.js.map

package/dist/cdp-selectors.d.ts

@@ -12,4 +12,3 @@ import { type ConnectionBudget } from './operation-budget.ts';
 export declare function registerCdpSelectors(context: BrowserContext, budget: ConnectionBudget): Promise<void>;
 /** Existing closed roots cannot be recovered if their document loaded without the tracking hook. */
 export declare function requireCdpShadowTracking(page: Page, budget: ConnectionBudget): Promise<void>;
-//# sourceMappingURL=cdp-selectors.d.ts.map

package/dist/cdp-selectors.js

@@ -49,4 +49,3 @@ export async function requireCdpShadowTracking(page, budget) {
         throw new EngineError('ENGINE_FAILURE', 'CDP recovery failed: closed shadow root tracking is unavailable after a document changed while disconnected; locators and secure-field masks need it', { retryable: false });
     }
 }
-//# sourceMappingURL=cdp-selectors.js.map

package/dist/closed-shadow.d.ts

@@ -61,4 +61,3 @@ export declare const CLOSED_SHADOW_SELECTOR_ENGINES: readonly {
     readonly name: string;
     readonly source: string;
 }[];
-//# sourceMappingURL=closed-shadow.d.ts.map

package/dist/closed-shadow.js

@@ -139,4 +139,3 @@ export const CLOSED_SHADOW_SELECTOR_ENGINES = [
     { name: CLOSED_SHADOW_SELECTOR_ENGINE, source: CLOSED_SHADOW_SELECTOR_ENGINE_SOURCE },
     { name: SEARCH_ROOTS_SELECTOR_ENGINE, source: SEARCH_ROOTS_SELECTOR_ENGINE_SOURCE },
 ];
-//# sourceMappingURL=closed-shadow.js.map

package/dist/dialogs.d.ts

@@ -35,4 +35,3 @@ export declare class DialogRouter {
     dispatch(dialog: PwDialog): Promise<void>;
     private route;
 }
-//# sourceMappingURL=dialogs.d.ts.map

package/dist/dialogs.js

@@ -84,4 +84,3 @@ export class DialogRouter {
         }
     }
 }
-//# sourceMappingURL=dialogs.js.map

package/dist/downloads.d.ts

@@ -26,4 +26,3 @@ export declare function saveFromBrowser(download: Download, downloads: LeaseDown
  * save names it.
  */
 export declare function saveLocally(download: Download, file: string, unserved: string | undefined): Promise<void>;
-//# sourceMappingURL=downloads.d.ts.map

package/dist/downloads.js

@@ -71,4 +71,3 @@ export async function saveLocally(download, file, unserved) {
         throw new EngineError('ENGINE_FAILURE', `download failed: ${message(cause)}; ${unserved}`, { retryable: false, cause });
     }
 }
-//# sourceMappingURL=downloads.js.map

package/dist/engine.d.ts

@@ -23,4 +23,3 @@ export interface PlaywrightLiveSurface {
 /** The live surface of a handle this module created, or undefined for any other engine. */
 export declare function surfaceOf(engine: EngineHandle): PlaywrightLiveSurface | undefined;
 export declare function web(options?: WebOptions): EngineHandle;
-//# sourceMappingURL=engine.d.ts.map

package/dist/engine.js

@@ -268,4 +268,3 @@ function ownVersion() {
         return 'unknown';
     }
 }
-//# sourceMappingURL=engine.js.map

package/dist/evaluation.d.ts

@@ -15,4 +15,3 @@ type EvaluationResult = {
  */
 export declare function compileEvaluation(source: string, hasArgument: boolean): (arg: unknown) => Promise<EvaluationResult>;
 export {};
-//# sourceMappingURL=evaluation.d.ts.map

package/dist/evaluation.js

@@ -32,4 +32,3 @@ export function compileEvaluation(source, hasArgument) {
         throw new TestError('EVALUATE_FAILED', message(cause), { cause });
     }
 }
-//# sourceMappingURL=evaluation.js.map

package/dist/in-page/read-semantics.d.ts

@@ -10,11 +10,9 @@ import type { SemanticMode, SemanticResult } from '../read-node.ts';
  * Serialized into the page by Playwright. Must stay self-contained: no outer
  * captures beyond its two arguments.
  *
- * `mode.kind === 'node'` reads exactly one element for locator reads. An
- * element no longer in its document reads as detached with its value alone:
- * a handle taken a moment earlier can point at a node the page has since
- * replaced, and what such a node reports (no boxes, so hidden) describes
- * nothing on screen.
+ * `mode.kind === 'node'` reads exactly one element for locator reads, in
+ * the selector engine's task that found it (`read-selector.ts`,
+ * `label-selector.ts`), so the element is always in its document.
  * `mode.kind === 'tree'` walks the subtree for one agent observation and
  * returns live element handles aligned with the flattened node list. The two
  * modes also project nodes differently; those differences are data (see
@@ -25,4 +23,3 @@ export declare const readSemanticsFunction: <Mode extends SemanticMode>(element:
     secureFieldSelector: string;
     mode: Mode;
 }) => SemanticResult<Mode>;
-//# sourceMappingURL=read-semantics.d.ts.map

package/dist/in-page/read-semantics.js

@@ -9,11 +9,9 @@
  * Serialized into the page by Playwright. Must stay self-contained: no outer
  * captures beyond its two arguments.
  *
- * `mode.kind === 'node'` reads exactly one element for locator reads. An
- * element no longer in its document reads as detached with its value alone:
- * a handle taken a moment earlier can point at a node the page has since
- * replaced, and what such a node reports (no boxes, so hidden) describes
- * nothing on screen.
+ * `mode.kind === 'node'` reads exactly one element for locator reads, in
+ * the selector engine's task that found it (`read-selector.ts`,
+ * `label-selector.ts`), so the element is always in its document.
  * `mode.kind === 'tree'` walks the subtree for one agent observation and
  * returns live element handles aligned with the flattened node list. The two
  * modes also project nodes differently; those differences are data (see
@@ -148,6 +146,10 @@ export const readSemanticsFunction = (element, options) => {
                 return 'textbox';
             case 'img':
                 return el.getAttribute('alt') === '' ? 'presentation' : 'image';
+            // An inline icon is a picture whether or not anything names it, as
+            // Playwright reads it; Chrome ignores an unnamed one.
+            case 'svg':
+                return 'image';
             case 'nav':
                 return 'navigation';
             case 'main':
@@ -355,6 +357,24 @@ export const readSemanticsFunction = (element, options) => {
         const alt = named ? el.getAttribute('alt') : null;
         return alt !== null && alt.trim() !== '' ? alt.trim() : null;
     };
+    /**
+     * The `<title>` child an SVG element is named by (SVG-AAM), as Playwright
+     * reads it: `<svg><title>Close</title></svg>` is the image "Close". An svg
+     * marked `presentation` or `none` takes no name of its own from it, though
+     * the title still names a link or button around it.
+     */
+    const svgTitleOf = (el) => {
+        if (!(el instanceof SVGElement))
+            return null;
+        const title = Array.from(el.children).find((child) => child instanceof SVGTitleElement);
+        const text = (title?.textContent ?? '').replace(/\s+/g, ' ').trim();
+        return text === '' ? null : text;
+    };
+    /** True for an element whose role removes its semantics: `presentation` or `none`. */
+    const isPresentational = (el) => {
+        const role = implicitRole(el);
+        return role === 'presentation' || role === 'none';
+    };
     /**
      * True for a referenced target accname 2A reads whole: hidden itself, or
      * under an `aria-hidden` ancestor, which excludes it from the tree as
@@ -428,9 +448,9 @@ export const readSemanticsFunction = (element, options) => {
         const ariaLabel = el.getAttribute('aria-label');
         if (ariaLabel !== null && ariaLabel.trim() !== '')
             return ariaLabel.trim();
-        const alt = altOf(el);
-        if (alt !== null)
-            return alt;
+        const alternative = altOf(el) ?? svgTitleOf(el);
+        if (alternative !== null)
+            return alternative;
         if (NAME_OPAQUE_TAGS.has(el.tagName))
             return '';
         const content = childrenNameOf(el, walk);
@@ -584,9 +604,9 @@ export const readSemanticsFunction = (element, options) => {
             if (joined !== '')
                 return joined;
         }
-        const alt = altOf(el);
-        if (alt !== null)
-            return alt;
+        const alternative = altOf(el) ?? (isPresentational(el) ? null : svgTitleOf(el));
+        if (alternative !== null)
+            return alternative;
         const captionTag = NAMING_CHILD_TAGS[el.tagName.toLowerCase()];
         if (captionTag !== undefined) {
             const caption = Array.from(el.children).find((child) => child.tagName.toLowerCase() === captionTag);
@@ -1154,7 +1174,7 @@ export const readSemanticsFunction = (element, options) => {
     // The conditional return type resolves per call site; inside the body the
     // discriminant narrows the value but not the generic, hence the two casts.
     if (options.mode.kind === 'node') {
-        return (element.isConnected ? describe(element) : { detached: true, value: describe(element).value });
+        return describe(element);
     }
     const maxNodes = options.mode.maxNodes;
     const nodes = [];
@@ -1187,8 +1207,7 @@ export const readSemanticsFunction = (element, options) => {
     const isInteresting = (el) => {
         if (el.hasAttribute(options.testIdAttribute))
             return true;
-        const role = implicitRole(el);
-        if (role !== null && role !== 'presentation' && role !== 'none')
+        if (implicitRole(el) !== null && !isPresentational(el))
             return true;
         if (accessibleName(el) !== null)
             return true;
@@ -1284,4 +1303,3 @@ export const readSemanticsFunction = (element, options) => {
         walk(child, 0);
     return { nodes, elements, ids, truncated };
 };
-//# sourceMappingURL=read-semantics.js.map

package/dist/index.d.ts

@@ -28,4 +28,3 @@ export declare const describe: {
 }>) => void, afterEach: (fn: import("e2e").TestHookFn<import("e2e").TestFixtures & {
     browser: Browser;
 }>) => void, beforeAll: (fn: import("e2e").SuiteHookFn) => void, afterAll: (fn: import("e2e").SuiteHookFn) => void;
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -13,4 +13,3 @@ export { web, surfaceOf } from './engine.js';
 export const test = base.extend();
 /** `describe` and the hooks, the same functions as `test.describe` and `test.beforeEach`, typed with the `browser` fixture. */
 export const { describe, beforeEach, afterEach, beforeAll, afterAll } = test;
-//# sourceMappingURL=index.js.map

package/dist/install.d.ts

@@ -37,4 +37,3 @@ export interface EnsureBrowsersOptions {
  * them with a registry lock.
  */
 export declare function ensureBrowsersInstalled(names: readonly BrowserName[], options?: EnsureBrowsersOptions): Promise<void>;
-//# sourceMappingURL=install.d.ts.map

package/dist/install.js

@@ -114,4 +114,3 @@ function runPlaywrightInstall(names, { log, signal, env }) {
         });
     });
 }
-//# sourceMappingURL=install.js.map

package/dist/label-selector.d.ts

@@ -34,4 +34,3 @@ export declare function exactLabelSelector(body: ExactLabelSelectorBody): string
  * page function.
  */
 export declare const EXACT_LABEL_SELECTOR_ENGINE_SOURCE: string;
-//# sourceMappingURL=label-selector.d.ts.map

package/dist/label-selector.js

@@ -50,4 +50,3 @@ export const EXACT_LABEL_SELECTOR_ENGINE_SOURCE = `() => {${CLOSED_SHADOW_HELPER
   };
   return { queryAll, query: (root, selector) => queryAll(root, selector)[0] ?? null };
 }`;
-//# sourceMappingURL=label-selector.js.map

package/dist/locators.d.ts

@@ -73,4 +73,3 @@ export declare function applyPostSteps<T>(matches: readonly T[], steps: readonly
 /** Returns every frame selector along an expression, outermost first. */
 export declare function frameSelectors(expression: LocatorExpression): string[];
 export {};
-//# sourceMappingURL=locators.d.ts.map

package/dist/locators.js

@@ -305,4 +305,3 @@ export function frameSelectors(expression) {
             return [expression.selector, ...frameSelectors(expression.source)];
     }
 }
-//# sourceMappingURL=locators.js.map

package/dist/observation-capture.d.ts

@@ -9,4 +9,3 @@ interface CaptureSettings {
 /** Captures under one deadline, retaining no refs from a failed or abandoned document. */
 export declare function captureObservation(page: Page, refs: RefRegistry, settings: CaptureSettings, operation: OperationContext, options: EngineObserveOptions | undefined): Promise<CapturedObservation>;
 export {};
-//# sourceMappingURL=observation-capture.d.ts.map

package/dist/observation-capture.js

@@ -90,4 +90,3 @@ export async function captureObservation(page, refs, settings, operation, option
         accepting = false;
     }
 }
-//# sourceMappingURL=observation-capture.js.map

package/dist/observation.d.ts

@@ -60,4 +60,3 @@ export interface CapturedDocument {
  */
 export declare function captureDocument(deps: CaptureDeps, host: DocumentHost, options: CaptureOptions): Promise<CapturedDocument>;
 export declare function toSemanticNode(ref: NodeRef, raw: RawNodeData, children?: readonly SemanticNode[], framePath?: readonly string[]): SemanticNode;
-//# sourceMappingURL=observation.d.ts.map

package/dist/observation.js

@@ -277,4 +277,3 @@ export function toSemanticNode(ref, raw, children = [], framePath = []) {
         ...(children.length > 0 ? { children } : {}),
     };
 }
-//# sourceMappingURL=observation.js.map

package/dist/observe.d.ts

@@ -48,4 +48,3 @@ export declare function readPngSize(data: Uint8Array): {
     width: number;
     height: number;
 } | null;
-//# sourceMappingURL=observe.d.ts.map

package/dist/observe.js

@@ -102,4 +102,3 @@ export function readPngSize(data) {
         return null;
     return { width, height };
 }
-//# sourceMappingURL=observe.js.map

package/dist/operation-budget.d.ts

@@ -8,4 +8,3 @@ export interface ConnectionBudget {
 export declare function connectionAbort(signal: AbortSignal, label: string): EngineError;
 /** Bounds the entire transition, aborts abandoned work, and never grants a fresh dispatch budget. */
 export declare function withConnectionBudget<T>(budget: ConnectionBudget, label: string, work: (remaining: () => ConnectionBudget) => Promise<T>): Promise<T>;
-//# sourceMappingURL=operation-budget.d.ts.map

package/dist/operation-budget.js

@@ -37,4 +37,3 @@ export async function withConnectionBudget(budget, label, work) {
         clearTimeout(timer);
     }
 }
-//# sourceMappingURL=operation-budget.js.map

package/dist/protected-app.d.ts

@@ -33,4 +33,3 @@ export declare function installSiteHeaders(context: BrowserContext, site: string
  * echoes its request headers shows that, not the password.
  */
 export declare function httpCredentials(basicAuth: WebBasicAuth, resolveSecret: (secret: Secret, options?: ResolveSecretOptions) => Promise<string>): Promise<PlaywrightHttpCredential>;
-//# sourceMappingURL=protected-app.d.ts.map

package/dist/protected-app.js

@@ -46,7 +46,6 @@ export async function httpCredentials(basicAuth, resolveSecret) {
  */
 function basicCredentials(username, password) {
     const encoded = Buffer.from(`${username}:${password}`, 'utf8').toString('base64');
-    const unpadded = encoded.replace(/=+$/, '');
+    const unpadded = encoded.replace(/={1,2}$/, '');
     return unpadded === encoded ? [encoded] : [encoded, unpadded];
 }
-//# sourceMappingURL=protected-app.js.map

package/dist/provider-video.d.ts

@@ -45,4 +45,3 @@ export declare class ProviderVideo implements AttemptVideo {
     /** Ends one of the provider's recordings as a segment of the attempt. */
     private stopLease;
 }
-//# sourceMappingURL=provider-video.d.ts.map

package/dist/provider-video.js

@@ -77,4 +77,3 @@ export class ProviderVideo {
         });
     }
 }
-//# sourceMappingURL=provider-video.js.map

package/dist/provider.d.ts

@@ -250,4 +250,3 @@ export declare class LeasedBrowsers {
     private release;
     private releaseContext;
 }
-//# sourceMappingURL=provider.d.ts.map

package/dist/provider.js

@@ -442,4 +442,3 @@ export class LeasedBrowsers {
         return { runId: run.runId, targetName: run.targetName, env: run.env, signal, log: run.log };
     }
 }
-//# sourceMappingURL=provider.js.map

package/dist/read-node.d.ts

@@ -1,9 +1,10 @@
 /**
- * The wire types of the in-page semantic reader and the page functions
- * assembled from its source for locator.evaluate, locator.evaluateAll, and
- * page.evaluate. The reader itself lives in `in-page/read-semantics.ts`; it is
- * serialized into the page, so every page function here is built from its
- * source with `new Function` and stays free of module-scope captures.
+ * The wire types of the in-page semantic reader and the document walk
+ * assembled from its source for page.evaluate. The reader itself lives in
+ * `in-page/read-semantics.ts`; it is serialized into the page, so the page
+ * function here is built from its source with `new Function` and stays free
+ * of module-scope captures. Locator reads run it inside the selector engines
+ * (`read-selector.ts`, `label-selector.ts`).
  */
 /**
  * The one definition of a secure field.
@@ -94,27 +95,10 @@ export type SemanticMode = {
     /** Cuts each node's text at this length; the caller owns the contract value. */
     textLimit: number;
 };
-/**
- * What a node read reports for an element no longer in its document. A
- * detached element has no boxes, so everything else it would report (hidden,
- * no labels) describes nothing on screen; its current value is still its own.
- */
-export interface DetachedNodeData {
-    readonly detached: true;
-    readonly value: string | null;
-}
 /** Result of one read, selected by the mode discriminant. */
 export type SemanticResult<Mode extends SemanticMode> = Mode extends {
     kind: 'node';
-} ? RawNodeData | DetachedNodeData : RawObservation;
-/** Options for a single-node read, shared by `evaluate` and `evaluateAll` callers. */
-interface NodeReadOptions {
-    readonly testIdAttribute: string;
-    readonly secureFieldSelector: string;
-    readonly mode: {
-        readonly kind: 'node';
-    };
-}
+} ? RawNodeData : RawObservation;
 /** Options for one document's tree walk. */
 interface TreeReadOptions {
     readonly testIdAttribute: string;
@@ -125,28 +109,9 @@ interface TreeReadOptions {
 }
 /**
  * Walks a whole document from its root element in one in-page call. Built
- * from the reader's source like the batch reader below, so the caller
+ * from the reader's source, so the caller
  * evaluates it directly on a page or frame instead of first resolving a
  * `:root` locator - one fewer protocol round trip per document per capture.
  */
 export declare const readDocumentSemanticsFunction: (options: TreeReadOptions) => RawObservation;
-/**
- * Reads every matched element in one in-page round trip. A page function
- * cannot close over module scope, so the batch function is assembled from the
- * reader's own source (the same source `evaluate` sends) and is a
- * self-contained function Playwright serializes and calls with the elements.
- */
-export declare const readManySemanticsFunction: (elements: Element[], options: NodeReadOptions) => (RawNodeData | DetachedNodeData)[];
-/**
- * Reads every handle the caller already holds in one round trip, so what is
- * read and what is later acted on are the same elements by construction rather
- * than by a second lookup. Evaluated on the first handle so the read runs in
- * the frame the handles belong to; `page.evaluate` would reject handles taken
- * inside an iframe.
- */
-export declare const readHandlesSemanticsFunction: (first: Element, arg: {
-    elements: Element[];
-    options: NodeReadOptions;
-}) => (RawNodeData | DetachedNodeData)[];
 export {};
-//# sourceMappingURL=read-node.d.ts.map

package/dist/read-node.js

@@ -1,9 +1,10 @@
 /**
- * The wire types of the in-page semantic reader and the page functions
- * assembled from its source for locator.evaluate, locator.evaluateAll, and
- * page.evaluate. The reader itself lives in `in-page/read-semantics.ts`; it is
- * serialized into the page, so every page function here is built from its
- * source with `new Function` and stays free of module-scope captures.
+ * The wire types of the in-page semantic reader and the document walk
+ * assembled from its source for page.evaluate. The reader itself lives in
+ * `in-page/read-semantics.ts`; it is serialized into the page, so the page
+ * function here is built from its source with `new Function` and stays free
+ * of module-scope captures. Locator reads run it inside the selector engines
+ * (`read-selector.ts`, `label-selector.ts`).
  */
 import { readSemanticsFunction } from './in-page/read-semantics.js';
 /**
@@ -19,24 +20,8 @@ import { readSemanticsFunction } from './in-page/read-semantics.js';
 export const SECURE_FIELD_SELECTOR = 'input[type="password" i]';
 /**
  * Walks a whole document from its root element in one in-page call. Built
- * from the reader's source like the batch reader below, so the caller
+ * from the reader's source, so the caller
  * evaluates it directly on a page or frame instead of first resolving a
  * `:root` locator - one fewer protocol round trip per document per capture.
  */
 export const readDocumentSemanticsFunction = new Function('options', `return (${readSemanticsFunction.toString()})(document.documentElement, options);`);
-/**
- * Reads every matched element in one in-page round trip. A page function
- * cannot close over module scope, so the batch function is assembled from the
- * reader's own source (the same source `evaluate` sends) and is a
- * self-contained function Playwright serializes and calls with the elements.
- */
-export const readManySemanticsFunction = new Function('elements', 'options', `return elements.map((element) => (${readSemanticsFunction.toString()})(element, options));`);
-/**
- * Reads every handle the caller already holds in one round trip, so what is
- * read and what is later acted on are the same elements by construction rather
- * than by a second lookup. Evaluated on the first handle so the read runs in
- * the frame the handles belong to; `page.evaluate` would reject handles taken
- * inside an iframe.
- */
-export const readHandlesSemanticsFunction = new Function('_first', 'arg', `return arg.elements.map((element) => (${readSemanticsFunction.toString()})(element, arg.options));`);
-//# sourceMappingURL=read-node.js.map