@umbraco/playwright-testhelpers 17.0.18 → 17.1.0-beta

package/dist/lib/helpers/BasePage.js

@@ -0,0 +1,543 @@
+"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 ?? 5000 });
+        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 forceClick(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 });
+    }
+    /**
+     * Clears an input field.
+     * @param locator - The input element to clear
+     */
+    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

@@ -0,0 +1 @@
+{"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 ?? 5000 });\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 forceClick(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; 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  }\n\n  /**\n   * Clears an input field.\n   * @param locator - The input element to clear\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"]}

package/dist/lib/helpers/ConstantHelper.d.ts

@@ -1,4 +1,21 @@
 export declare class ConstantHelper {
+    static readonly timeout: {
+        short: number;
+        medium: number;
+        long: number;
+        veryLong: number;
+        navigation: number;
+        pageLoad: number;
+    };
+    static readonly wait: {
+        minimal: number;
+        short: number;
+        medium: number;
+        long: number;
+        animation: number;
+        debounce: number;
+        networkIdle: number;
+    };
     static readonly sections: {
         content: string;
         media: string;

package/dist/lib/helpers/ConstantHelper.js

@@ -2,6 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConstantHelper = void 0;
 class ConstantHelper {
+    static timeout = {
+        short: 1000,
+        medium: 5000,
+        long: 10000,
+        veryLong: 30000,
+        navigation: 30000,
+        pageLoad: 60000
+    };
+    static wait = {
+        minimal: 100,
+        short: 500,
+        medium: 1000,
+        long: 2000,
+        animation: 300,
+        debounce: 400,
+        networkIdle: 5000
+    };
     static sections = {
         content: "Content",
         media: "Media",