@umbraco/playwright-testhelpers 17.1.0-beta.5 → 17.1.0-beta.7

package/dist/lib/helpers/BasePage.js

@@ -1,547 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BasePage = void 0;
-const test_1 = require("@playwright/test");
-/**
- * Base page class providing common UI interaction methods.
- * All methods follow best practices for reliability:
- * - click: Always checks element visibility before clicking
- * - enterText: Always clears before filling text
- * - select: Waits for element visibility before selecting
- *
- * @example
- * ```typescript
- * class MyPage extends BasePage {
- *   readonly submitBtn: Locator;
- *
- *   constructor(page: Page) {
- *     super(page);
- *     this.submitBtn = page.getByRole('button', {name: 'Submit'});
- *   }
- *
- *   async submit() {
- *     await this.click(this.submitBtn);
- *   }
- * }
- * ```
- */
-class BasePage {
-    page;
-    constructor(page) {
-        this.page = page;
-    }
-    /**
-     * Clicks an element after verifying it is visible.
-     * @param locator - The element to click
-     * @param options - Optional click configuration
-     */
-    async click(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 7000 });
-        await locator.click({ force: options?.force });
-    }
-    /**
-     * Double-clicks an element after verifying it is visible.
-     * @param locator - The element to double-click
-     * @param options - Optional configuration
-     */
-    async doubleClick(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.dblclick({ force: options?.force });
-    }
-    /**
-     * Right-clicks an element after verifying it is visible.
-     * @param locator - The element to right-click
-     * @param options - Optional configuration
-     */
-    async rightClick(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.click({ button: 'right', force: options?.force });
-    }
-    /**
-     * Clicks an element using JavaScript (bypasses actionability checks).
-     * Use when standard click doesn't work due to overlapping elements.
-     * @param locator - The element to click
-     */
-    async javascriptClick(locator) {
-        await locator.evaluate((el) => el.click());
-    }
-    /**
-     * Enters text into an input field after clearing it.
-     * Verifies element visibility before interaction.
-     * @param locator - The input element
-     * @param text - The text to enter
-     * @param options - Optional configuration
-     */
-    async enterText(locator, text, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        if (options?.clearFirst !== false) {
-            await locator.clear();
-        }
-        await locator.fill(text);
-        if (options?.verify) {
-            await (0, test_1.expect)(locator).toHaveValue(text);
-        }
-    }
-    /**
-     * Types text character by character (simulates real typing).
-     * Useful when fill() doesn't trigger necessary events.
-     * @param locator - The input element
-     * @param text - The text to type
-     * @param options - Optional configuration
-     */
-    async typeText(locator, text, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        if (options?.clearFirst !== false) {
-            await locator.clear();
-        }
-        await locator.pressSequentially(text, { delay: options?.delay ?? 50 });
-        if (options?.verify) {
-            await (0, test_1.expect)(locator).toHaveValue(text);
-        }
-    }
-    /**
-     * Clears an input field.
-     * @param locator - The input element to clear
-     * @param options - Optional configuration
-     */
-    async clearText(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.clear();
-    }
-    /**
-     * Presses a keyboard key while focused on an element.
-     * @param locator - The element to focus
-     * @param key - The key to press (e.g., 'Enter', 'Tab', 'Escape')
-     */
-    async pressKey(locator, key, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.press(key);
-    }
-    /**
-     * Selects an option from a dropdown by value.
-     * @param locator - The select element
-     * @param value - The option value to select
-     */
-    async selectByValue(locator, value, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.selectOption({ value });
-    }
-    /**
-     * Selects an option from a dropdown by visible text.
-     * @param locator - The select element
-     * @param text - The option text to select
-     */
-    async selectByText(locator, text, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.selectOption({ label: text });
-    }
-    /**
-     * Selects an option from a dropdown by index.
-     * @param locator - The select element
-     * @param index - The option index to select (0-based)
-     */
-    async selectByIndex(locator, index, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.selectOption({ index });
-    }
-    /**
-     * Selects multiple options from a multi-select dropdown.
-     * @param locator - The select element
-     * @param values - Array of option values to select
-     */
-    async selectMultiple(locator, values, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.selectOption(values);
-    }
-    /**
-     * Checks a checkbox if it's not already checked.
-     * @param locator - The checkbox element
-     */
-    async check(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.check({ force: options?.force });
-    }
-    /**
-     * Unchecks a checkbox if it's currently checked.
-     * @param locator - The checkbox element
-     */
-    async uncheck(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.uncheck({ force: options?.force });
-    }
-    /**
-     * Sets a checkbox to a specific state.
-     * @param locator - The checkbox element
-     * @param checked - Whether the checkbox should be checked
-     */
-    async setChecked(locator, checked, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.setChecked(checked, { force: options?.force });
-    }
-    /**
-     * Hovers over an element.
-     * @param locator - The element to hover over
-     */
-    async hover(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.hover({ force: options?.force });
-    }
-    /**
-     * Focuses on an element.
-     * @param locator - The element to focus
-     */
-    async focus(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.focus();
-    }
-    /**
-     * Hovers over one element and clicks another (for menus that appear on hover).
-     * @param hoverLocator - The element to hover over
-     * @param clickLocator - The element to click after hover
-     */
-    async hoverAndClick(hoverLocator, clickLocator, options) {
-        await (0, test_1.expect)(hoverLocator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await hoverLocator.hover();
-        await (0, test_1.expect)(clickLocator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await clickLocator.click({ force: options?.force });
-    }
-    /**
-     * Waits for an element to be visible.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForVisible(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be hidden.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForHidden(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeHidden({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be attached to the DOM.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForAttached(locator, timeout) {
-        await locator.waitFor({ state: 'attached', timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be detached from the DOM.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForDetached(locator, timeout) {
-        await locator.waitFor({ state: 'detached', timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for the page to finish loading (network idle).
-     */
-    async waitForPageLoad() {
-        await this.page.waitForLoadState('networkidle');
-    }
-    /**
-     * Waits for the DOM to be fully loaded.
-     */
-    async waitForDOMContentLoaded() {
-        await this.page.waitForLoadState('domcontentloaded');
-    }
-    /**
-     * Waits for all network requests to complete.
-     */
-    async waitForLoadState() {
-        await this.page.waitForLoadState();
-    }
-    /**
-     * Waits for an element to be enabled.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForEnabled(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeEnabled({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be disabled.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForDisabled(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeDisabled({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to contain specific text.
-     * @param locator - The element to wait for
-     * @param text - The text to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForText(locator, text, timeout) {
-        await (0, test_1.expect)(locator).toContainText(text, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an input to have a specific value.
-     * @param locator - The input element to wait for
-     * @param value - The value to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForValue(locator, value, timeout) {
-        await (0, test_1.expect)(locator).toHaveValue(value, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to have a specific attribute value.
-     * @param locator - The element to wait for
-     * @param name - The attribute name
-     * @param value - The expected attribute value
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForAttribute(locator, name, value, timeout) {
-        await (0, test_1.expect)(locator).toHaveAttribute(name, value, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to have a specific CSS class.
-     * @param locator - The element to wait for
-     * @param className - The CSS class to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForClass(locator, className, timeout) {
-        await (0, test_1.expect)(locator).toHaveClass(className, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be editable.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForEditable(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeEditable({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be checked.
-     * @param locator - The checkbox/radio element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForChecked(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeChecked({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be unchecked.
-     * @param locator - The checkbox/radio element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForUnchecked(locator, timeout) {
-        await (0, test_1.expect)(locator).not.toBeChecked({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for a specific URL or URL pattern.
-     * @param url - The URL string or regex pattern to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForURL(url, timeout) {
-        await this.page.waitForURL(url, { timeout: timeout ?? 30000 });
-    }
-    /**
-     * Waits for a navigation to complete.
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForNavigation(timeout) {
-        await this.page.waitForLoadState('load', { timeout: timeout ?? 30000 });
-    }
-    /**
-     * Waits for a specific time (use sparingly, prefer explicit waits).
-     * @param milliseconds - Time to wait in milliseconds
-     */
-    async waitForTimeout(milliseconds) {
-        await this.page.waitForTimeout(milliseconds);
-    }
-    /**
-     * Waits for a network request to a specific URL.
-     * @param urlOrPredicate - URL string, regex, or predicate function
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForRequest(urlOrPredicate, timeout) {
-        return await this.page.waitForRequest(urlOrPredicate, { timeout: timeout ?? 30000 });
-    }
-    /**
-     * Waits for a network response from a specific URL.
-     * @param urlOrPredicate - URL string, regex, or predicate function
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForResponse(urlOrPredicate, timeout) {
-        return await this.page.waitForResponse(urlOrPredicate, { timeout: timeout ?? 30000 });
-    }
-    /**
-     * Waits for an element to be focused.
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForFocused(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeFocused({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for an element to be empty (no text content).
-     * @param locator - The element to wait for
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForEmpty(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeEmpty({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Waits for a function to return true.
-     * @param predicate - Function that returns a boolean or Promise<boolean>
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForFunction(predicate, timeout) {
-        await this.page.waitForFunction(predicate, { timeout: timeout ?? 30000 });
-    }
-    /**
-     * Waits for an element to have a specific CSS property value.
-     * @param locator - The element to wait for
-     * @param property - The CSS property name
-     * @param value - The expected CSS property value
-     * @param timeout - Maximum time to wait in milliseconds
-     */
-    async waitForCSS(locator, property, value, timeout) {
-        await (0, test_1.expect)(locator).toHaveCSS(property, value, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element is visible.
-     * @param locator - The element to check
-     * @param isVisible - Whether the element should be visible (default: true)
-     */
-    async isVisible(locator, isVisible = true, timeout) {
-        await (0, test_1.expect)(locator).toBeVisible({ visible: isVisible, timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element is enabled.
-     * @param locator - The element to check
-     */
-    async isEnabled(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeEnabled({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element is disabled.
-     * @param locator - The element to check
-     */
-    async isDisabled(locator, timeout) {
-        await (0, test_1.expect)(locator).toBeDisabled({ timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element contains specific text.
-     * @param locator - The element to check
-     * @param text - The text to look for
-     */
-    async containsText(locator, text, timeout) {
-        await (0, test_1.expect)(locator).toContainText(text, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element has specific text.
-     * @param locator - The element to check
-     * @param text - The exact text expected
-     */
-    async hasText(locator, text, timeout) {
-        await (0, test_1.expect)(locator).toHaveText(text, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an input has a specific value.
-     * @param locator - The input element to check
-     * @param value - The expected value
-     */
-    async hasValue(locator, value, timeout) {
-        await (0, test_1.expect)(locator).toHaveValue(value, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that an element has a specific attribute value.
-     * @param locator - The element to check
-     * @param name - The attribute name
-     * @param value - The expected attribute value
-     */
-    async hasAttribute(locator, name, value, timeout) {
-        await (0, test_1.expect)(locator).toHaveAttribute(name, value, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Asserts that a specific number of elements exist.
-     * @param locator - The locator to count
-     * @param count - The expected count
-     */
-    async hasCount(locator, count, timeout) {
-        await (0, test_1.expect)(locator).toHaveCount(count, { timeout: timeout ?? 5000 });
-    }
-    /**
-     * Gets the text content of an element.
-     * @param locator - The element to get text from
-     * @returns The text content
-     */
-    async getText(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        return await locator.textContent() ?? '';
-    }
-    /**
-     * Gets the value of an input element.
-     * @param locator - The input element
-     * @returns The input value
-     */
-    async getValue(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        return await locator.inputValue();
-    }
-    /**
-     * Gets an attribute value from an element.
-     * @param locator - The element
-     * @param attributeName - The attribute name
-     * @returns The attribute value or null
-     */
-    async getAttribute(locator, attributeName, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        return await locator.getAttribute(attributeName);
-    }
-    /**
-     * Checks if an element is currently visible.
-     * @param locator - The element to check
-     * @returns True if visible, false otherwise
-     */
-    async checkIsVisible(locator) {
-        return await locator.isVisible();
-    }
-    /**
-     * Checks if a checkbox is checked.
-     * @param locator - The checkbox element
-     * @returns True if checked, false otherwise
-     */
-    async isChecked(locator) {
-        return await locator.isChecked();
-    }
-    /**
-     * Scrolls an element into view.
-     * @param locator - The element to scroll to
-     */
-    async scrollIntoView(locator, options) {
-        await (0, test_1.expect)(locator).toBeVisible({ timeout: options?.timeout ?? 5000 });
-        await locator.scrollIntoViewIfNeeded();
-    }
-    /**
-     * Sets files on a file input element.
-     * @param locator - The file input element
-     * @param filePath - Path to the file(s) to set
-     */
-    async setInputFiles(locator, filePath) {
-        await locator.setInputFiles(filePath);
-    }
-    /**
-     * Clears files from a file input.
-     * @param locator - The file input element
-     */
-    async clearInputFiles(locator) {
-        await locator.setInputFiles([]);
-    }
-    /**
-     * Drags an element and drops it on another element.
-     * @param source - The element to drag
-     * @param target - The element to drop on
-     */
-    async dragTo(source, target, options) {
-        await source.dragTo(target, options);
-    }
-}
-exports.BasePage = BasePage;
-//# sourceMappingURL=BasePage.js.map

package/dist/lib/helpers/BasePage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BasePage.js","sourceRoot":"","sources":["../../../lib/helpers/BasePage.ts"],"names":[],"mappings":"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","sourcesContent":["import {expect, Locator, Page} from \"@playwright/test\";\n\n/**\n * Base page class providing common UI interaction methods.\n * All methods follow best practices for reliability:\n * - click: Always checks element visibility before clicking\n * - enterText: Always clears before filling text\n * - select: Waits for element visibility before selecting\n *\n * @example\n * ```typescript\n * class MyPage extends BasePage {\n *   readonly submitBtn: Locator;\n *\n *   constructor(page: Page) {\n *     super(page);\n *     this.submitBtn = page.getByRole('button', {name: 'Submit'});\n *   }\n *\n *   async submit() {\n *     await this.click(this.submitBtn);\n *   }\n * }\n * ```\n */\nexport class BasePage {\n  readonly page: Page;\n\n  constructor(page: Page) {\n    this.page = page;\n  }\n\n  /**\n   * Clicks an element after verifying it is visible.\n   * @param locator - The element to click\n   * @param options - Optional click configuration\n   */\n  async click(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 7000});\n    await locator.click({force: options?.force});\n  }\n\n  /**\n   * Double-clicks an element after verifying it is visible.\n   * @param locator - The element to double-click\n   * @param options - Optional configuration\n   */\n  async doubleClick(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.dblclick({force: options?.force});\n  }\n\n  /**\n   * Right-clicks an element after verifying it is visible.\n   * @param locator - The element to right-click\n   * @param options - Optional configuration\n   */\n  async rightClick(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.click({button: 'right', force: options?.force});\n  }\n\n  /**\n   * Clicks an element using JavaScript (bypasses actionability checks).\n   * Use when standard click doesn't work due to overlapping elements.\n   * @param locator - The element to click\n   */\n  async javascriptClick(locator: Locator): Promise<void> {\n    await locator.evaluate((el: HTMLElement) => el.click());\n  }\n\n  /**\n   * Enters text into an input field after clearing it.\n   * Verifies element visibility before interaction.\n   * @param locator - The input element\n   * @param text - The text to enter\n   * @param options - Optional configuration\n   */\n  async enterText(\n    locator: Locator,\n    text: string,\n    options?: {clearFirst?: boolean; verify?: boolean; timeout?: number}\n  ): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    if (options?.clearFirst !== false) {\n      await locator.clear();\n    }\n    await locator.fill(text);\n    if (options?.verify) {\n      await expect(locator).toHaveValue(text);\n    }\n  }\n\n  /**\n   * Types text character by character (simulates real typing).\n   * Useful when fill() doesn't trigger necessary events.\n   * @param locator - The input element\n   * @param text - The text to type\n   * @param options - Optional configuration\n   */\n  async typeText(\n    locator: Locator,\n    text: string,\n    options?: {clearFirst?: boolean; verify?: boolean; delay?: number; timeout?: number}\n  ): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    if (options?.clearFirst !== false) {\n      await locator.clear();\n    }\n    await locator.pressSequentially(text, {delay: options?.delay ?? 50});\n    if (options?.verify) {\n      await expect(locator).toHaveValue(text);\n    }\n  }\n\n  /**\n   * Clears an input field.\n   * @param locator - The input element to clear\n   * @param options - Optional configuration\n   */\n  async clearText(locator: Locator, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.clear();\n  }\n\n  /**\n   * Presses a keyboard key while focused on an element.\n   * @param locator - The element to focus\n   * @param key - The key to press (e.g., 'Enter', 'Tab', 'Escape')\n   */\n  async pressKey(locator: Locator, key: string, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.press(key);\n  }\n\n  /**\n   * Selects an option from a dropdown by value.\n   * @param locator - The select element\n   * @param value - The option value to select\n   */\n  async selectByValue(locator: Locator, value: string, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.selectOption({value});\n  }\n\n  /**\n   * Selects an option from a dropdown by visible text.\n   * @param locator - The select element\n   * @param text - The option text to select\n   */\n  async selectByText(locator: Locator, text: string, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.selectOption({label: text});\n  }\n\n  /**\n   * Selects an option from a dropdown by index.\n   * @param locator - The select element\n   * @param index - The option index to select (0-based)\n   */\n  async selectByIndex(locator: Locator, index: number, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.selectOption({index});\n  }\n\n  /**\n   * Selects multiple options from a multi-select dropdown.\n   * @param locator - The select element\n   * @param values - Array of option values to select\n   */\n  async selectMultiple(locator: Locator, values: string[], options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.selectOption(values);\n  }\n\n  /**\n   * Checks a checkbox if it's not already checked.\n   * @param locator - The checkbox element\n   */\n  async check(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.check({force: options?.force});\n  }\n\n  /**\n   * Unchecks a checkbox if it's currently checked.\n   * @param locator - The checkbox element\n   */\n  async uncheck(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.uncheck({force: options?.force});\n  }\n\n  /**\n   * Sets a checkbox to a specific state.\n   * @param locator - The checkbox element\n   * @param checked - Whether the checkbox should be checked\n   */\n  async setChecked(locator: Locator, checked: boolean, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.setChecked(checked, {force: options?.force});\n  }\n\n  /**\n   * Hovers over an element.\n   * @param locator - The element to hover over\n   */\n  async hover(locator: Locator, options?: {force?: boolean; timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.hover({force: options?.force});\n  }\n\n  /**\n   * Focuses on an element.\n   * @param locator - The element to focus\n   */\n  async focus(locator: Locator, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.focus();\n  }\n\n  /**\n   * Hovers over one element and clicks another (for menus that appear on hover).\n   * @param hoverLocator - The element to hover over\n   * @param clickLocator - The element to click after hover\n   */\n  async hoverAndClick(\n    hoverLocator: Locator,\n    clickLocator: Locator,\n    options?: {force?: boolean; timeout?: number}\n  ): Promise<void> {\n    await expect(hoverLocator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await hoverLocator.hover();\n    await expect(clickLocator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await clickLocator.click({force: options?.force});\n  }\n\n  /**\n   * Waits for an element to be visible.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForVisible(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeVisible({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be hidden.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForHidden(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeHidden({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be attached to the DOM.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForAttached(locator: Locator, timeout?: number): Promise<void> {\n    await locator.waitFor({state: 'attached', timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be detached from the DOM.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForDetached(locator: Locator, timeout?: number): Promise<void> {\n    await locator.waitFor({state: 'detached', timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for the page to finish loading (network idle).\n   */\n  async waitForPageLoad(): Promise<void> {\n    await this.page.waitForLoadState('networkidle');\n  }\n\n  /**\n   * Waits for the DOM to be fully loaded.\n   */\n  async waitForDOMContentLoaded(): Promise<void> {\n    await this.page.waitForLoadState('domcontentloaded');\n  }\n\n  /**\n   * Waits for all network requests to complete.\n   */\n  async waitForLoadState(): Promise<void> {\n    await this.page.waitForLoadState();\n  }\n\n  /**\n   * Waits for an element to be enabled.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForEnabled(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeEnabled({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be disabled.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForDisabled(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeDisabled({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to contain specific text.\n   * @param locator - The element to wait for\n   * @param text - The text to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForText(locator: Locator, text: string, timeout?: number): Promise<void> {\n    await expect(locator).toContainText(text, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an input to have a specific value.\n   * @param locator - The input element to wait for\n   * @param value - The value to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForValue(locator: Locator, value: string, timeout?: number): Promise<void> {\n    await expect(locator).toHaveValue(value, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to have a specific attribute value.\n   * @param locator - The element to wait for\n   * @param name - The attribute name\n   * @param value - The expected attribute value\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForAttribute(locator: Locator, name: string, value: string | RegExp, timeout?: number): Promise<void> {\n    await expect(locator).toHaveAttribute(name, value, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to have a specific CSS class.\n   * @param locator - The element to wait for\n   * @param className - The CSS class to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForClass(locator: Locator, className: string | RegExp, timeout?: number): Promise<void> {\n    await expect(locator).toHaveClass(className, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be editable.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForEditable(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeEditable({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be checked.\n   * @param locator - The checkbox/radio element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForChecked(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeChecked({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be unchecked.\n   * @param locator - The checkbox/radio element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForUnchecked(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).not.toBeChecked({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for a specific URL or URL pattern.\n   * @param url - The URL string or regex pattern to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForURL(url: string | RegExp, timeout?: number): Promise<void> {\n    await this.page.waitForURL(url, {timeout: timeout ?? 30000});\n  }\n\n  /**\n   * Waits for a navigation to complete.\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForNavigation(timeout?: number): Promise<void> {\n    await this.page.waitForLoadState('load', {timeout: timeout ?? 30000});\n  }\n\n  /**\n   * Waits for a specific time (use sparingly, prefer explicit waits).\n   * @param milliseconds - Time to wait in milliseconds\n   */\n  async waitForTimeout(milliseconds: number): Promise<void> {\n    await this.page.waitForTimeout(milliseconds);\n  }\n\n  /**\n   * Waits for a network request to a specific URL.\n   * @param urlOrPredicate - URL string, regex, or predicate function\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForRequest(urlOrPredicate: string | RegExp | ((request: any) => boolean), timeout?: number): Promise<any> {\n    return await this.page.waitForRequest(urlOrPredicate, {timeout: timeout ?? 30000});\n  }\n\n  /**\n   * Waits for a network response from a specific URL.\n   * @param urlOrPredicate - URL string, regex, or predicate function\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForResponse(urlOrPredicate: string | RegExp | ((response: any) => boolean), timeout?: number): Promise<any> {\n    return await this.page.waitForResponse(urlOrPredicate, {timeout: timeout ?? 30000});\n  }\n\n  /**\n   * Waits for an element to be focused.\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForFocused(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeFocused({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for an element to be empty (no text content).\n   * @param locator - The element to wait for\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForEmpty(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeEmpty({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Waits for a function to return true.\n   * @param predicate - Function that returns a boolean or Promise<boolean>\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForFunction(predicate: () => boolean | Promise<boolean>, timeout?: number): Promise<void> {\n    await this.page.waitForFunction(predicate, {timeout: timeout ?? 30000});\n  }\n\n  /**\n   * Waits for an element to have a specific CSS property value.\n   * @param locator - The element to wait for\n   * @param property - The CSS property name\n   * @param value - The expected CSS property value\n   * @param timeout - Maximum time to wait in milliseconds\n   */\n  async waitForCSS(locator: Locator, property: string, value: string | RegExp, timeout?: number): Promise<void> {\n    await expect(locator).toHaveCSS(property, value, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element is visible.\n   * @param locator - The element to check\n   * @param isVisible - Whether the element should be visible (default: true)\n   */\n  async isVisible(locator: Locator, isVisible: boolean = true, timeout?: number): Promise<void> {\n    await expect(locator).toBeVisible({visible: isVisible, timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element is enabled.\n   * @param locator - The element to check\n   */\n  async isEnabled(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeEnabled({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element is disabled.\n   * @param locator - The element to check\n   */\n  async isDisabled(locator: Locator, timeout?: number): Promise<void> {\n    await expect(locator).toBeDisabled({timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element contains specific text.\n   * @param locator - The element to check\n   * @param text - The text to look for\n   */\n  async containsText(locator: Locator, text: string, timeout?: number): Promise<void> {\n    await expect(locator).toContainText(text, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element has specific text.\n   * @param locator - The element to check\n   * @param text - The exact text expected\n   */\n  async hasText(locator: Locator, text: string, timeout?: number): Promise<void> {\n    await expect(locator).toHaveText(text, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an input has a specific value.\n   * @param locator - The input element to check\n   * @param value - The expected value\n   */\n  async hasValue(locator: Locator, value: string, timeout?: number): Promise<void> {\n    await expect(locator).toHaveValue(value, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that an element has a specific attribute value.\n   * @param locator - The element to check\n   * @param name - The attribute name\n   * @param value - The expected attribute value\n   */\n  async hasAttribute(locator: Locator, name: string, value: string, timeout?: number): Promise<void> {\n    await expect(locator).toHaveAttribute(name, value, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Asserts that a specific number of elements exist.\n   * @param locator - The locator to count\n   * @param count - The expected count\n   */\n  async hasCount(locator: Locator, count: number, timeout?: number): Promise<void> {\n    await expect(locator).toHaveCount(count, {timeout: timeout ?? 5000});\n  }\n\n  /**\n   * Gets the text content of an element.\n   * @param locator - The element to get text from\n   * @returns The text content\n   */\n  async getText(locator: Locator, options?: {timeout?: number}): Promise<string> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    return await locator.textContent() ?? '';\n  }\n\n  /**\n   * Gets the value of an input element.\n   * @param locator - The input element\n   * @returns The input value\n   */\n  async getValue(locator: Locator, options?: {timeout?: number}): Promise<string> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    return await locator.inputValue();\n  }\n\n  /**\n   * Gets an attribute value from an element.\n   * @param locator - The element\n   * @param attributeName - The attribute name\n   * @returns The attribute value or null\n   */\n  async getAttribute(locator: Locator, attributeName: string, options?: {timeout?: number}): Promise<string | null> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    return await locator.getAttribute(attributeName);\n  }\n\n  /**\n   * Checks if an element is currently visible.\n   * @param locator - The element to check\n   * @returns True if visible, false otherwise\n   */\n  async checkIsVisible(locator: Locator): Promise<boolean> {\n    return await locator.isVisible();\n  }\n\n  /**\n   * Checks if a checkbox is checked.\n   * @param locator - The checkbox element\n   * @returns True if checked, false otherwise\n   */\n  async isChecked(locator: Locator): Promise<boolean> {\n    return await locator.isChecked();\n  }\n\n  /**\n   * Scrolls an element into view.\n   * @param locator - The element to scroll to\n   */\n  async scrollIntoView(locator: Locator, options?: {timeout?: number}): Promise<void> {\n    await expect(locator).toBeVisible({timeout: options?.timeout ?? 5000});\n    await locator.scrollIntoViewIfNeeded();\n  }\n\n  /**\n   * Sets files on a file input element.\n   * @param locator - The file input element\n   * @param filePath - Path to the file(s) to set\n   */\n  async setInputFiles(locator: Locator, filePath: string | string[]): Promise<void> {\n    await locator.setInputFiles(filePath);\n  }\n\n  /**\n   * Clears files from a file input.\n   * @param locator - The file input element\n   */\n  async clearInputFiles(locator: Locator): Promise<void> {\n    await locator.setInputFiles([]);\n  }\n\n  /**\n   * Drags an element and drops it on another element.\n   * @param source - The element to drag\n   * @param target - The element to drop on\n   */\n  async dragTo(\n    source: Locator,\n    target: Locator,\n    options?: {sourcePosition?: {x: number; y: number}; targetPosition?: {x: number; y: number}}\n  ): Promise<void> {\n    await source.dragTo(target, options);\n  }\n\n}\n"]}