@e2e-dev/web 0.11.0-canary-20260928184528

package/dist/engine.js

@@ -0,0 +1,176 @@
+/**
+ * The Playwright engine for e2e: a browser body built with the
+ * public `defineEngine`, validated by the same rules and graded by the same
+ * capabilities as any other engine. Core imports nothing from here; this
+ * package imports the contract from `e2e/engine` and contributes the `web`
+ * fixture the way a device engine contributes `device`.
+ */
+import { ConfigurationError, defineEngine, LOCATOR_ACTION_KINDS, POINTER_ACTION_KINDS, obj, } from 'e2e/engine';
+import { createRequire } from 'node:module';
+import { asBrowserProvider } from './provider.js';
+import { PlaywrightSurface } from './surface.js';
+import { createWebFixture } from './web.js';
+/** Creates one Playwright engine: one browser per worker, one context per attempt. */
+const surfaces = new WeakMap();
+/** The live surface of a handle this module created, or undefined for any other engine. */
+export function surfaceOf(engine) {
+    const surface = surfaces.get(engine);
+    if (surface === undefined)
+        return undefined;
+    return { page: () => surface.requirePage(), context: () => surface.requireContext() };
+}
+export function web(options = {}) {
+    const provider = typeof options.browser === 'object' && options.browser !== null ? asBrowserProvider(options.browser) : undefined;
+    if (provider !== undefined && options.connect !== undefined) {
+        throw new ConfigurationError('INVALID_CONFIG', `web({ browser, connect }) names two browser sources; browser provider "${provider.name}" leases its own browsers, so remove connect`);
+    }
+    if (options.connect !== undefined && typeof options.browser === 'string' && options.browser !== 'chromium') {
+        throw new ConfigurationError('INVALID_CONFIG', `web({ connect }) requires the chromium browser; CDP attach is chromium-only, got "${options.browser}"`);
+    }
+    if ('allowedOrigins' in options) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ allowedOrigins }) is gone: navigation and secret fills are not gated by origin; remove the option');
+    }
+    if (options.headers !== undefined)
+        validateHeaders(options.headers);
+    if (options.basicAuth !== undefined)
+        validateBasicAuth(options.basicAuth);
+    if (options.testIdAttribute !== undefined)
+        validateTestIdAttribute(options.testIdAttribute);
+    const reconnecting = options.connect?.reconnectEndpoint !== undefined;
+    if (reconnecting && typeof options.connect?.reconnectEndpoint !== 'function') {
+        throw new ConfigurationError('INVALID_CONFIG', 'connect.reconnectEndpoint must be a function');
+    }
+    // A per-attempt lease rides the same persistent context as `reconnectEndpoint`, with the same limits.
+    const recoverable = reconnecting || provider?.scope === 'attempt';
+    if (recoverable && (options.headers !== undefined || options.basicAuth !== undefined)) {
+        const mode = provider === undefined ? 'connect.reconnectEndpoint' : `browser provider "${provider.name}" with scope "attempt"`;
+        throw new ConfigurationError('INVALID_CONFIG', `${mode} uses a persistent context; headers and basicAuth require a newly created context`);
+    }
+    const surface = new PlaywrightSurface(options);
+    const handle = defineEngine({
+        name: 'web',
+        version: ownVersion(),
+        spiVersion: 1,
+        platform: 'web',
+        prepare: (info) => surface.prepare(info),
+        finish: (info) => surface.finish(info),
+        init: (info) => surface.init(info),
+        startAttempt: (context) => surface.startAttempt(context),
+        settleAttempt: (context) => surface.settleAttempt(context),
+        endAttempt: (context) => surface.endAttempt(context),
+        dispose: (context) => surface.dispose(context),
+        observe: (operation, observeOptions) => surface.observe(operation, observeOptions),
+        locate: (expression, operation) => surface.locate(expression, operation),
+        perform: (ref, action, operation) => surface.perform(ref, action, operation),
+        // A browser honors every action kind of the contract; `actions.ts` dispatches each.
+        actions: LOCATOR_ACTION_KINDS,
+        // A page takes every pointer action of the contract at a bare point too.
+        performAt: (point, action, operation) => surface.performAt(point, action, operation),
+        pointerActions: POINTER_ACTION_KINDS,
+        keyboard: {
+            type: (text, keyboardOptions, operation) => surface.typeText(text, keyboardOptions, operation),
+            press: (key, operation) => surface.pressKey(key, operation),
+        },
+        app: declaredApp(options),
+        session: {
+            open: (url, operation) => surface.open(url, operation),
+            back: (operation) => surface.back(operation),
+            restart: (operation) => surface.restart(operation),
+            ...(recoverable ? {} : { reset: (operation) => surface.reset(operation) }),
+        },
+        artifacts: {
+            screenshot: (label, operation) => surface.screenshot(label, operation),
+            startTrace: (operation) => surface.startTrace(operation),
+            stopTrace: (operation) => surface.stopTrace(operation),
+            startVideo: (operation) => surface.startVideo(operation),
+            stopVideo: (operation) => surface.stopVideo(operation),
+        },
+        ...(recoverable
+            ? {}
+            : {
+                state: {
+                    capture: (operation) => surface.captureState(operation),
+                    restore: (state, operation) => surface.restoreState(state, operation),
+                },
+            }),
+        fixtures: {
+            web: (context) => createWebFixture(surface, context),
+        },
+    });
+    surfaces.set(handle, surface);
+    return handle;
+}
+/** An HTTP header field name: one or more `token` characters (RFC 9110). */
+const HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
+/** A control character no HTTP field value may carry; a horizontal tab is the one the grammar allows. */
+// oxlint-disable-next-line no-control-regex -- the control characters are the point
+const FIELD_VALUE_CONTROL = /[\u0000-\u0008\u000A-\u001F\u007F]/;
+/** True for a plain object; the shape both options take. Config runs as JavaScript, so the types alone are no guard. */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Refuses a header the browser could not send, at config load rather than at
+ * the first request: a name outside the token grammar, a value carrying a
+ * control character (a line break is a header-injection vector), or a value
+ * that is not a string at all.
+ */
+function validateHeaders(headers) {
+    if (!isRecord(headers)) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ headers }) must be an object of header name to value');
+    }
+    for (const [name, value] of Object.entries(headers)) {
+        if (!HEADER_NAME.test(name)) {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) has an invalid header name: "${name}"`);
+        }
+        if (typeof value !== 'string') {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) header "${name}" must be a string, got ${typeof value}`);
+        }
+        if (FIELD_VALUE_CONTROL.test(value)) {
+            throw new ConfigurationError('INVALID_CONFIG', `web({ headers }) header "${name}" must not contain a control character`);
+        }
+    }
+}
+/** Refuses credentials the browser could not present: a missing field, or a `:` in the user name (RFC 7617). */
+function validateBasicAuth(basicAuth) {
+    if (!isRecord(basicAuth)) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) must be an object with username and password');
+    }
+    const { username, password } = basicAuth;
+    if (typeof username !== 'string' || username === '') {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) requires a non-empty username string');
+    }
+    if (username.includes(':')) {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) username must not contain ":"');
+    }
+    if (typeof password !== 'string') {
+        throw new ConfigurationError('INVALID_CONFIG', 'web({ basicAuth }) requires a password string');
+    }
+}
+/**
+ * An attribute name the document grammar accepts (XML `Name`, ASCII): a value
+ * outside it could never be on an element, so `getByTestId` would match nothing
+ * and every `testId` query would fail silently.
+ */
+const ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
+/** Refuses a test-id attribute no element could carry, at config load. */
+function validateTestIdAttribute(attribute) {
+    if (typeof attribute !== 'string' || !ATTRIBUTE_NAME.test(attribute)) {
+        throw new ConfigurationError('INVALID_CONFIG', `web({ testIdAttribute }) must be an attribute name such as "data-testid", got ${JSON.stringify(attribute)}`);
+    }
+}
+/** The app-declaration half of the options, so browser knobs never reach the manifest. */
+function declaredApp(options) {
+    const { url, environment, identity, command, readyUrl, services } = options;
+    return obj({ url, environment, identity, command, readyUrl, services });
+}
+/** This package's published version, read through require resolution. */
+function ownVersion() {
+    try {
+        return createRequire(import.meta.url)('../package.json').version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/evaluation.d.ts

@@ -0,0 +1,18 @@
+type EvaluationResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Compiles the page-side error boundary without evaluating the caller's source in this process.
+ *
+ * A function serialized with `toString()` carries whatever the loader compiled
+ * it to. tsx runs esbuild with `keepNames`, which wraps every nested named
+ * binding in a module-scoped `__name(target, name)` helper; the page has no
+ * such helper, so the same one is declared next to the inlined source.
+ */
+export declare function compileEvaluation(source: string, hasArgument: boolean): (arg: unknown) => Promise<EvaluationResult>;
+export {};
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../src/evaluation.ts"],"names":[],"mappings":"AAIA,KAAK,gBAAgB,GACjB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAqBnH"}

package/dist/evaluation.js

@@ -0,0 +1,35 @@
+/** Separates exceptions thrown by trusted page code from failures of the evaluation transport. */
+import { TestError } from 'e2e/engine';
+import { message } from './support.js';
+/**
+ * Compiles the page-side error boundary without evaluating the caller's source in this process.
+ *
+ * A function serialized with `toString()` carries whatever the loader compiled
+ * it to. tsx runs esbuild with `keepNames`, which wraps every nested named
+ * binding in a module-scoped `__name(target, name)` helper; the page has no
+ * such helper, so the same one is declared next to the inlined source.
+ */
+export function compileEvaluation(source, hasArgument) {
+    try {
+        return new Function('arg', `
+      return (async () => {
+        const __name = (target, value) => Object.defineProperty(target, 'name', { value, configurable: true });
+        try {
+          return { ok: true, value: await (${source}\n)(${hasArgument ? 'arg' : ''}) };
+        } catch (cause) {
+          let message;
+          try {
+            message = typeof cause?.message === 'string' ? cause.message : String(cause);
+          } catch {
+            message = 'Page evaluation threw an unprintable value';
+          }
+          return { ok: false, message };
+        }
+      })();
+    `);
+    }
+    catch (cause) {
+        throw new TestError('EVALUATE_FAILED', message(cause), { cause });
+    }
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../src/evaluation.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,WAAoB;IACpE,IAAI,CAAC;QACH,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE;;;;6CAIc,MAAM,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;KAW7E,CAAgD,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * The in-page semantic reader. Playwright serializes it with `toString()` and
+ * runs it inside the page (`read-node.ts` assembles the three page functions
+ * from its source), so it must stay one self-contained function: no imports
+ * beyond types, no module-scope references, every constant inside the body.
+ * That is why it has a file of its own.
+ */
+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 === '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
+ * `projection` below), not scattered branches.
+ */
+export declare const readSemanticsFunction: <Mode extends SemanticMode>(element: Element, options: {
+    testIdAttribute: string;
+    secureFieldSelector: string;
+    mode: Mode;
+}) => SemanticResult<Mode>;
+//# sourceMappingURL=read-semantics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-semantics.d.ts","sourceRoot":"","sources":["../../src/in-page/read-semantics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAgC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAI,IAAI,SAAS,YAAY,WACpD,OAAO,WACP;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,KAC5E,cAAc,CAAC,IAAI,CAunCrB,CAAC"}