@playq/core 0.2.77

package/dist/helper/actions/web/validationActions.d.ts

@@ -0,0 +1,547 @@
+import { Page, Locator } from "@playwright/test";
+export declare function see(page: Page, text: string, options?: string | Record<string, any>): Promise<void>;
+export declare function dontSee(page: Page, text: string, options?: string | Record<string, any>): Promise<void>;
+export declare function count(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<number>;
+/**
+ * Web: See Page Title -text: {param} -options: {param}
+ *
+ * Verifies the page title matches the expected text.
+ * Supports exact and partial match, case sensitivity, and screenshot capture.
+ *
+ * @param page Playwright Page instance
+ * @param expectedTitle The expected page title to match (e.g., "Your store").
+ * @param options Optional JSON string or object:
+ *   - partialMatch: [boolean] Perform partial match on title (default: false)
+ *   - ignoreCase: [boolean] Case-insensitive comparison (default: false)
+ *   - assert: [boolean] If false, logs failure but does not throw (default: true)
+ *   - screenshot: [boolean] Capture a screenshot (default: true)
+ *   - screenshotText: [string] Description for screenshot
+ *   - screenshotFullPage: [boolean] Full page screenshot (default: true)
+ *
+ * @example
+ *  Web: See Page Title -text: "Your store" -options: "{partialMatch: true, ignoreCase: false, assert: true}"
+ */
+export declare function seePageTitle(page: Page, expectedTitle: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify page title -text: {param} -options: {param}
+ *
+ * Verifies the page title matches the expected text.
+ *
+ * @param expectedTitle - The expected page title to match (e.g., "Your store").
+ * @param options - Optional JSON string or object, supporting fields:
+ *   - partial_check: [boolean] Perform partial match (default: false).
+ *   - ignoreCase: [boolean] Case-sensitive match (default: true).
+ *   - assert: [boolean] If false, continues the test even if the verification fails. Default: true.
+ *   - screenshot: [boolean] Capture screenshot after verification (default: true).
+ *   - screenshotText: [string] Description for screenshot attachment.
+ *   - screenshotFullPage: [boolean] Full page screenshot (default: true).
+ *
+ * Example usage:
+ *  * Web: Verify page title -text: "Your store" -options: "{partial_check: true, ignoreCase: false, assert: true}"
+ */
+export declare function verifyPageTitle(page: Page, expectedTitle: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify header text -field: {param} -options: {param}
+ *
+ * Verifies that a header element's text (e.g., h1, h2, h3) matches the expected text. Supports partial or exact match, case sensitivity, and optional screenshot capture. The field parameter is the expected text, while pattern refines element selection if needed.
+ *
+ * @param field - The expected header text to match (e.g., "Welcome", "Dashboard").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional Action timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - navigationTimeout: [number] Optional Navigation timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - partialMatch: [boolean] Perform a partial match instead of an exact match. Default: false.
+ *   - pattern: [string] Override the default pattern from config for element resolution. Default: Configured pattern in config.
+ *   - ignoreCase: [boolean] Perform a case-sensitive match. Default: false.
+ *   - assert: [boolean] If false, continues the test even if the verification fails. Default: true.
+ *   - locator: [string] Optional locator to refine element search. Default: "". Eg:locator: locator: "xpath=(//h3[@class='module-title'])[1]"
+ *   - headerType: [string] Specify a header level (e.g., "h1", "h2", "h3"). Default: Checks all headers from h1 to h4.
+ *   - screenshot: [boolean] Capture a screenshot during verification. Default: true.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Verify header text -field: "Your Account Has Been Created!" -options: "{partialMatch: true, screenshot: true, screenshotText: 'After account creation',  locator: "xpath=(//h3[@class='module-title'])[1]" }"
+ */
+export declare function verifyHeaderText(page: Page, expectedText: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify text on page -text: {param} -options: {param}
+ *
+ * Verifies that the provided text is present somewhere in the page.
+ *
+ * @param text - The expected text to search for on the page.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - partialMatch: [boolean] Perform a partial match instead of an exact match. Default: false.
+ *   - ignoreCase: [boolean] Perform a case-sensitive match. Default: false.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture a screenshot. Default: true.
+ *   - screenshotText: [string] Description for the screenshot.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Verify text on page -text: "Welcome back!" -options: "{partialMatch: true, screenshot: true, screenshotText: 'Verifying greeting'}"
+ */
+export declare function verifyTextOnPage(page: Page, text: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify text not empty at location -field: {param} -options: {param}
+ *
+ * Verifies that the text content of an element is not empty.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, id, name, or selector of the element to verify
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyTextNotEmptyAtLocation(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify text at location -field: {param} -value: {param} -options: {param}
+ *
+ * Verifies that the text content of an element matches the expected value.
+ *
+ * @param field - The label, id, name, or selector of the element to verify.
+ * @param expectedText - The expected text content.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - partialMatch: [boolean] If true, performs substring match. Default: false.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - ignoreCase: [boolean] Whether the match is case-sensitive. Default: true.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyTextAtLocation(page: Page, field: string | Locator, expectedText: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify input field is blank -field: {param} -options: {param}
+ *
+ * Verifies that an input field is blank (empty value).
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, id, name, selector, or Locator for the input field
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyInputFieldIsBlank(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify input field is present -field: {param} -options: {param}
+ *
+ * Verifies that an input field is present on the page, identified by label, text, id, name, or pattern.
+ *
+ * @param field - The label, text, id, name, or selector of the input field to verify (e.g., "Email", "Password").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search. Default: Configured pattern.
+ *   - assert: [boolean] If false, continues the test even if the verification fails. Default: true.
+ *   - screenshot: [boolean] Capture a screenshot during verification. Default: true.
+ *   - screenshotText: [string] Text description for the screenshot. Default: "".
+ *   - screenshotFullPage: [boolean] Capture a full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Verify input field is present -field: "Email" -options: "{screenshot: true, screenshotText: 'Verifying Email input field'}"
+ */
+export declare function verifyInputFieldPresent(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify input field value -field: {param} -value: {param} -options: {param}
+ *
+ * Verifies that the value of an input field matches the expected value.
+ *
+ * @param field - The label, id, name, or selector of the input field to verify.
+ * @param expectedValue - The expected value of the input field.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - partialMatch: [boolean] If true, performs substring match. Default: false.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - ignoreCase: [boolean] Whether the match is case-sensitive. Default: true.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyInputFieldValue(page: Page, field: string | Locator, expectedValue: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify locked input field value -field: {param} -value: {param} -options: {param}
+ *
+ * Verifies that the value of an locked input field matches the expected value.
+ *
+ * @param field - The label, id, name, or selector of the input field to verify.
+ * @param expectedValue - The expected value of the input field.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - partialMatch: [boolean] If true, performs substring match. Default: false.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - ignoreCase: [boolean] Whether the match is case-sensitive. Default: true.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyLockedInputFieldValue(page: Page, field: string | Locator, expectedValue: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify Tab field Present -field: {param} -options: {param}
+ *
+ * Verifies that a "Tab" field is present on the page, identified by label, text, id, name, or pattern.
+ *
+ * @param field - The label, text, id, name, or selector of the tab to verify (e.g., "Overview", "Settings").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds for waiting. Default: from [config] or 30000.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - isPresent: [boolean] Check Tab is present on the page. Default: true.
+ *   - isEnabled: [boolean] Check if Tab is enabled. Default: false.
+ *   - isSelected: [boolean] Check if Tab is selected. Default: false.
+ *   - isNotSelected: [boolean] Check if Tab is not selected. Default: false.
+ *   - screenshot: [boolean] Capture a screenshot. Default: true.
+ *   - screenshotText: [string] Description for the screenshot.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifyTabField(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify Toast Text Contains -text: {param} -options: {param}
+ *
+ * Verifies that a toast (notification) element appears on the page and contains the expected text.
+ * Throws an error (or logs a warning if `assert: false`) if the text is not found.
+ *
+ * @param page - Playwright Page instance.
+ * @param text - The expected substring to match within the toast notification (e.g., "Saved successfully").
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Timeout in milliseconds to wait for toast visibility. Default: 30000.
+ *   - pattern: [string] Optional pattern to refine toast element search (e.g., class name or attribute).
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture a screenshot after verification. Default: true.
+ *   - screenshotText: [string] Description for screenshot attachment.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ * Web: Verify Toast Text Contains -text: "Saved successfully"
+ */
+export declare function verifyToastTextContains(page: Page, text: string, options?: any): Promise<void>;
+/**
+ * Web: Verify text to disappear at location -field: {param} -text: {param} -options: {param}
+ *
+ * Verifies that the specified text disappears from the given field/locator within a timeout.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The selector or Locator where the text should disappear
+ * @param textToDisappear - The text to wait for disappearance
+ * @param options - Optional string or object:
+ *   - actionTimeout: [number] Timeout in ms (default: 30000)
+ *   - partialMatch: [boolean] If true, waits for substring match (default: false)
+ *   - ignoreCase: [boolean] If true, match is case-insensitive (default: true)
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot after waiting (default: true)
+ *   - screenshotText: [string] Description for screenshot
+ *   - screenshotFullPage: [boolean] Full page screenshot (default: true)
+ *
+ * @example
+ *   await verifyTextToDisappearAtLocation(page, 'h1', 'Loading...', { actionTimeout: 10000, partialMatch: true });
+ */
+export declare function verifyTextToDisappearAtLocation(page: Page, field: string | Locator, textToDisappear: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify field is locked -field: {param} -options: {param}
+ * Verifies that the specified field on the page is locked (read-only).
+ * Designed for use in Cucumber step definitions.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the field.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ * - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ */
+export declare function verifyFieldIsLocked(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify field is mandatory -field: {param} -options: {param}
+ * Verifies that the specified field on the page is locked (read-only).
+ * Designed for use in Cucumber step definitions.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the field.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ * - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ */
+export declare function verifyFieldIsMandatory(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify field is secured -field: {param} -options: {param}
+ * Verifies that the specified field on the page is secured.
+ * Designed for use in Cucumber step definitions.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the field.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ * - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ */
+export declare function verifyFieldIsSecured(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify select field value -field: {param} -value: {param} -options: {param}
+ *
+ * Verifies that the value of a select field matches the expected value.
+ *
+ * @param field - The label, id, name, or selector of the select field to verify.
+ * @param expectedValue - The expected value of the select field.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - partialMatch: [boolean] If true, performs substring match. Default: false.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - ignoreCase: [boolean] Whether the match is case-sensitive. Default: true.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ */
+export declare function verifySelectDropdownValue(page: Page, field: string | Locator, expectedValue: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify select list does not have given value -field: {param} -value: {param} -options: {param}
+ *
+ * Verifies that a select dropdown does NOT contain the specified value in its options list.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, id, name, or selector of the select field to verify.
+ * @param excludedValue - The value that should NOT be present in the dropdown options.
+ * @param options - Optional JSON string or object:
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - ignoreCase: [boolean] Whether the match is case-sensitive. Default: true.
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  Web: Verify select list does not have given value -field: "Country" -value: "Antarctica" -options: "{screenshot: true, screenshotText: 'Verified Antarctica not in list'}"
+ */
+export declare function verifySelectListNotHaveGivenValue(page: Page, field: string | Locator, excludedValue: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is present/visible -field: {param} -options: {param}
+ *
+ * Generic presence/visibility check for any element type (button, input, dropdown, text, etc.)
+ * using PlayQ locator system and fieldType, with support for exact/partial match.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, text, id, name, or selector of the element to verify
+ * @param options - Optional JSON string or object:
+ *   - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", "text", etc.)
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *   - unique: [boolean] If true, require exactly one match. Default: false.
+ *
+ * @example
+ *   await web.verifyElementPresent(page, "My Button", { fieldType: "button" });
+ *   await web.verifyElementPresent(page, "Search", { fieldType: "input", partialMatch: true });
+ */
+export declare function verifyElementPresent(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is NOT present/visible -field: {param} -options: {param}
+ *
+ * Generic absence/invisibility check for any element type (button, input, dropdown, text, etc.)
+ * using PlayQ locator system and fieldType, with support for exact/partial match.
+ *
+ * @param page - Playwright Page instance
+ * @param field - The label, text, id, name, or selector of the element to verify
+ * @param options - Optional JSON string or object:
+ *   - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", "text", etc.)
+ *   - actionTimeout: [number] Optional timeout in milliseconds. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture screenshot. Default: true.
+ *   - screenshotText: [string] Screenshot description.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *   - unique: [boolean] If true, require exactly one match. Default: false.
+ *
+ * @example
+ *   await web.verifyElementNotPresent(page, "My Button", { fieldType: "button" });
+ *   await web.verifyElementNotPresent(page, "Search", { fieldType: "input", partialMatch: true });
+ */
+export declare function verifyElementNotPresent(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is enabled -field: {param} -options: {param}
+ *
+ * Verifies that the specified element on the page is enabled (not disabled).
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the element to verify.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", etc.)
+ *  - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *  - pattern: [string] Optional pattern to refine element search.
+ *  - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *  - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ *  - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  await web.verifyElementEnabled(page, "Submit Button", { fieldType: "button" });
+ *
+ */
+export declare function verifyElementEnabled(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is disabled -field: {param} -options: {param}
+ *
+ * Verifies that the specified element on the page is disabled (not enabled).
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the element to verify.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", etc.)
+ *  - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *  - pattern: [string] Optional pattern to refine element search.
+ *  - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *  - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ *  - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ * await web.verifyElementDisabled(page, "Submit Button", { fieldType: "button" });
+ *
+ */
+export declare function verifyElementDisabled(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is selected -field: {param} -options: {param}
+ *
+ * Verifies that the specified element on the page is selected (e.g., checkbox, radio button, option).
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the element to verify.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - fieldType: [string] Type of element (e.g., "checkbox", "radio", "option", etc.)
+ *  - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *  - pattern: [string] Optional pattern to refine element search.
+ *  - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *  - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ *  - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ *
+ * @example
+ * await web.verifyElementSelected(page, "Accept Terms", { fieldType: "checkbox" });
+ *
+ */
+export declare function verifyElementSelected(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;
+/**
+ *
+ * Web: Verify element has attribute -field: {param} -attribute: {param} -value: {param} -options: {param}
+ *
+ * Verifies that the specified element on the page has the given attribute with the expected value.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the element to verify.
+ * @param attribute - The attribute name to check (e.g., "href", "src", "alt", etc.).
+ * @param expectedValue - The expected value of the attribute.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", etc.)
+ * - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ * - pattern: [string] Optional pattern to refine element search.
+ * - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ * - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ * - screenshot: [boolean] Capture a screenshot. Default: true.
+ * - screenshotText: [string] Description for the screenshot.
+ * - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ *  await web.verifyElementHasAttribute(page, "My Link", "href", "https://example.com", { fieldType: "link" });
+ *
+ */
+export declare function verifyElementHasAttribute(page: Page, field: string | Locator, attribute: string, expectedValue: string, options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element count -field: {param} -expectedCount: {param} -options: {param}
+ *
+ * Verifies that the count of specified elements on the page matches the expected count.
+ *
+ *  @param page - Playwright Page instance.
+ *  @param field - The label, text, id, name, or selector of the element to verify.
+ *  @param expectedCount - The expected number of elements to be present.
+ *  @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *   - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", etc.)
+ *   - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture a screenshot. Default: true.
+ *   - screenshotText: [string] Description for the screenshot.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ *
+ * @example
+ * await web.verifyElementCount(page, "Item", 5, { fieldType: "text" });
+ *
+ *
+ */
+export declare function verifyElementCount(page: Page, field: string | Locator, expectedCount: number, options?: string | Record<string, any>): Promise<void>;
+/**
+ *
+
+/**
+ * Web: Verify element order -field: {param} -expectedOrder: {param} -options: {param}
+ *
+ * Verifies that the order of elements of a specified type on the page matches the expected order.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The locator, label, text, id, name, or selector of the elements to verify (string or Locator).
+ * @param expectedOrder - An array of expected element texts in the correct order.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *   - fieldType: [string] The type of elements to verify (e.g., "text", "button", "item", etc.).
+ *   - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *   - pattern: [string] Optional pattern to refine element search.
+ *   - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *   - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *   - screenshot: [boolean] Capture a screenshot. Default: true.
+ *   - screenshotText: [string] Description for the screenshot.
+ *   - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ * // Using a string field (label or logical type)
+ * await web.verifyElementOrder(page, "Phase", ["Draft", "Review", "Approved"], { fieldType: "phase", partialMatch: false });
+ *
+ * // Using a Playwright Locator (e.g., all visible rows in a table)
+ * const rows = page.locator('.my-table-row');
+ * await web.verifyElementOrder(page, rows, ["Row 1", "Row 2", "Row 3"]);
+ */
+export declare function verifyElementOrder(page: Page, field: string | Locator, expectedOrder: string[], options?: string | Record<string, any>): Promise<void>;
+/**
+ * Web: Verify element is in viewport -field: {param} -options: {param}
+ *
+ * Verifies that the specified element on the page is within the visible viewport.
+ *
+ * @param page - Playwright Page instance.
+ * @param field - The label, text, id, name, or selector of the element to verify.
+ * @param options - Optional settings for the verification action. Can be a JSON string or an object:
+ *  - fieldType: [string] Type of element (e.g., "button", "input", "dropdown", etc.)
+ *  - actionTimeout: [number] Timeout in milliseconds to wait for page load. Default: Configured timeout.
+ *  - pattern: [string] Optional pattern to refine element search.
+ *  - partialMatch: [boolean] If true, allows substring match. Default: false (exact match).
+ *  - assert: [boolean] If false, logs the failure but does not throw. Default: true.
+ *  - screenshot: [boolean] Capture a screenshot. Default: true.
+ *  - screenshotText: [string] Description for the screenshot.
+ *  - screenshotFullPage: [boolean] Capture full page screenshot. Default: true.
+ *
+ * @example
+ * await web.verifyElementInViewport(page, "Submit Button", { fieldType: "button" });
+ *
+ *
+ */
+export declare function verifyElementInViewport(page: Page, field: string | Locator, options?: string | Record<string, any>): Promise<void>;