playwright-cucumber-ts-steps/lib/assertions/semanticSteps.d.ts

A collection of reusable Playwright step definitions for Cucumber in TypeScript, designed to streamline end-to-end testing across web, API, and mobile applications.

import { DataTable } from "@cucumber/cucumber";
import type { CustomWorld } from "../helpers/world";
/**
 * Asserts that a heading element (h1-h6) containing the given text is visible on the page.
 *
 * ```gherkin
 * Then I see heading {string}
 * ```
 *
 * @param text - The text content expected within the heading.
 *
 * @example
 * Then I see heading "Welcome to your account"
 *
 * @remarks
 * This step searches for any HTML heading tag (`<h1>` through `<h6>`) that contains the specified text.
 * It uses Playwright's `expect().toBeVisible()` to confirm both existence and visibility, which
 * includes automatic waiting.
 * @category Heading Assertion Steps
 */
export declare function Then_I_see_heading(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that a heading element (h1-h6) containing the given text is NOT visible on the page.
 *
 * ```gherkin
 * Then I do not see heading {string}
 * ```
 *
 * @param text - The text content expected NOT to be visible within a heading.
 *
 * @example
 * Then I do not see heading "Hidden Section"
 *
 * @remarks
 * This step searches for any HTML heading tag (`<h1>` through `<h6>`) that contains the specified text.
 * It uses Playwright's `expect().not.toBeVisible()` to confirm both absence and non-visibility,
 * which includes automatic waiting.
 * @category Heading Assertion Steps
 */
export declare function Then_I_do_not_see_heading(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that a `<label>` element with the given text is visible on the page.
 *
 * ```gherkin
 * Then I see label {string}
 * ```
 *
 * @param text - The text content of the label expected to be visible.
 *
 * @example
 * Then I see label "Username"
 * Then I see label "I agree to the terms and conditions"
 *
 * @remarks
 * This step uses Playwright's `page.getByLabel()` which is designed to find labels
 * and implicitly connected form controls. It then uses `expect().toBeVisible()`
 * to confirm visibility.
 * @category Label Assertion Steps
 */
export declare function Then_I_see_label(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that a `<label>` element with the given text is NOT visible on the page.
 *
 * ```gherkin
 * Then I do not see label {string}
 * ```
 *
 * @param text - The text content of the label expected NOT to be visible.
 *
 * @example
 * Then I do not see label "Old Feature Toggle"
 *
 * @remarks
 * This step uses Playwright's `page.getByLabel()` and then `expect().not.toBeVisible()`
 * to confirm its non-visibility.
 * @category Label Assertion Steps
 */
export declare function Then_I_do_not_see_label(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that a link (`<a>` tag) with the given accessible name (text content) is visible on the page.
 *
 * ```gherkin
 * Then I see link {string}
 * ```
 *
 * @param text - The accessible name (text) of the link expected to be visible.
 *
 * @example
 * Then I see link "Home"
 * Then I see link "View Details"
 *
 * @remarks
 * This step uses Playwright's `page.getByRole("link", { name: text })` for robust
 * link finding based on accessible name, then `expect().toBeVisible()` for visibility.
 * @category Link Assertion Steps
 */
export declare function Then_I_see_link(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that a link (`<a>` tag) with the given accessible name (text content) is NOT visible on the page.
 *
 * ```gherkin
 * Then I do not see link {string}
 * ```
 *
 * @param text - The accessible name (text) of the link expected NOT to be visible.
 *
 * @example
 * Then I do not see link "Admin Panel"
 *
 * @remarks
 * This step uses Playwright's `page.getByRole("link", { name: text })` and then
 * `expect().not.toBeVisible()` to confirm its non-visibility.
 * @category Link Assertion Steps
 */
export declare function Then_I_do_not_see_link(this: CustomWorld, text: string): Promise<void>;
/**
 * Asserts that the number of elements found by the {@link CustomWorld.currentLocator | currentLocator}
 * matches the expected count. If no `currentLocator` is set, it defaults to counting all elements (`*`).
 *
 * ```gherkin
 * Then I count {int} element
 * ```
 *
 * @param expectedCount - The expected number of elements.
 *
 * @example
 * When I find elements by selector ".product-item"
 * Then I count 10 element
 *
 * @remarks
 * This step is designed to follow a "find elements" step that sets `this.currentLocator`
 * or `this.elements` (if `this.elements` is the intended source, you might prefer a
 * step like `Then I count {int} elements` which specifically targets `this.elements`).
 * The current implementation uses `this.currentLocator` or defaults to `this.page.locator("*")`.
 * @category Count Assertion Steps
 */
export declare function Then_I_count_current_locator_elements(this: CustomWorld, expectedCount: number): Promise<void>;
/**
 * Asserts that the current document title exactly matches the expected string.
 *
 * ```gherkin
 * Then I see document title {string}
 * ```
 *
 * @param expectedTitle - The exact title string expected for the document.
 * @param table - (Optional) A Cucumber DataTable for Playwright `ExpectOptions` (e.g., `timeout`).
 *
 * @example
 * Then I see document title "My Application Dashboard"
 *
 * @remarks
 * This step uses Playwright's `expect(page).toHaveTitle()` for robust assertion,
 * including automatic waiting for the title to become correct.
 * @category Page State Assertion Steps
 */
export declare function Then_I_see_document_title(this: CustomWorld, expectedTitle: string, table?: DataTable): Promise<void>;
/**
 * Asserts that the current document title contains the expected substring (case-insensitive).
 *
 * ```gherkin
 * Then I see document title contains {string}
 * ```
 *
 * @param substring - The substring expected to be contained within the document title.
 * @param table - (Optional) A Cucumber DataTable for Playwright `ExpectOptions`.
 *
 * @example
 * Then I see document title contains "App Name"
 * Then I see document title contains "Dashboard"
 *
 * @remarks
 * This step uses Playwright's `expect(page).toHaveTitle()` with a case-insensitive regular
 * expression for partial matching, ensuring automatic waiting.
 * @category Page State Assertion Steps
 */
export declare function Then_I_see_document_title_contains(this: CustomWorld, substring: string, table?: DataTable): Promise<void>;