UNPKG

cypress-cucumber-steps

Version:
414 lines 9.62 kB
import { DataTable } from '@badeball/cypress-cucumber-preprocessor'; /** * When I click: * * ```gherkin * When I click * ``` * * Clicks on the element found in the previous step. * * Alternative: * * - {@link When_I_click_on_text | When I click on text} * - {@link When_I_click_position | When I click position} * - {@link When_I_click_x_y_coordinates | When I click x-y coordinates} * * @example * * ```gherkin * When I click * ``` * * With [options](https://docs.cypress.io/api/commands/click#Arguments): * * ```gherkin * When I click * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | log | true | * | force | false | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * ``` * * @remarks * * A preceding step like {@link When_I_find_element_by_text | "When I find element by text"} is required. For example: * * ```gherkin * When I find element by text "Text" * And I click * ``` * * @see * * - {@link When_I_double_click | When I double-click} * - {@link When_I_right_click | When I right-click} */ export declare function When_I_click(options?: DataTable): void; /** * When I click position: * * ```gherkin * When I click {string} * ``` * * Clicks on the position of the element found in the previous step. * * You can click on 9 specific positions of an element: * * ``` * ------------------------------------- * | top-left top top-right | * | | * | | * | | * | left center right | * | | * | | * | | * | bottom-left bottom bottom-right | * ------------------------------------- * ``` * * @example * * ```gherkin * When I click "top-left" * ``` * * With [options](https://docs.cypress.io/api/commands/click#Arguments): * * ```gherkin * When I click "top" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | log | true | * | force | false | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * ``` * * @remarks * * A preceding step like {@link When_I_find_element_by_text | "When I find element by text"} is required. For example: * * ```gherkin * When I find element by text "Text" * And I click "top-right" * ``` * * @see * * - {@link When_I_click | When I click} * - {@link When_I_click_x_y_coordinates | When I click x-y coordinates} */ export declare function When_I_click_position(position: 'top' | 'left' | 'center' | 'right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right', options?: DataTable): void; /** * When I click x-y coordinates: * * ```gherkin * When I click {int}px and {int}px * ``` * * Clicks on the x-y coordinates of the element found in the previous step. * * @example * * ```gherkin * When I click 80px and 75px * ``` * * With [options](https://docs.cypress.io/api/commands/click#Arguments): * * ```gherkin * When I click 80px and 75px * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | log | true | * | force | false | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * ``` * * @remarks * * A preceding step like {@link When_I_find_element_by_text | "When I find element by text"} is required. For example: * * ```gherkin * When I find element by text "Text" * And I click 80px and 75px * ``` * * @see * * - {@link When_I_click | When I click} * - {@link When_I_click_position | When I click position} */ export declare function When_I_click_x_y_coordinates(x: number, y: number, options?: DataTable): void; /** * When I click on button: * * ```gherkin * When I click on button {string} * ``` * * Clicks on the first button with the matching text. * * @example * * ```gherkin * When I click on button "Button" * ``` * * With options: * * ```gherkin * When I click on button "Button" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * | withinSubject | null | * ``` * * @see * * - {@link When_I_click_on_text | When I click on text} */ export declare function When_I_click_on_button(text: string, options?: DataTable): void; /** * When I click on link: * * ```gherkin * When I click on link {string} * ``` * * Clicks on the first link with the matching text. * * @example * * ```gherkin * When I click on link "Link" * ``` * * With options: * * ```gherkin * When I click on link "Link" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * | withinSubject | null | * ``` * * @see * * - {@link When_I_click_on_text | When I click on text} */ export declare function When_I_click_on_link(text: string, options?: DataTable): void; /** * When I click on text: * * ```gherkin * When I click on text {string} * ``` * * Clicks on the first element with the matching text. * * Alternative: * * - {@link When_I_click | When I click} * * @example * * ```gherkin * When I click on text "Text" * ``` * * With options: * * ```gherkin * When I click on text "Text" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | matchCase | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * ``` * * @see * * - {@link When_I_click_on_button | When I click on button} * - {@link When_I_click_on_label | When I click on label} * - {@link When_I_click_on_link | When I click on link} */ export declare function When_I_click_on_text(text: string, options?: DataTable): void; /** * When I click on label: * * ```gherkin * When I click on label {string} * ``` * * Clicks on the first label with the matching text. * * @example * * ```gherkin * When I click on label "Label" * ``` * * With options: * * ```gherkin * When I click on label "Label" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * | withinSubject | null | * | pseudoSelector | visible | * ``` * * @see * * - {@link When_I_click_on_text | When I click on text} */ export declare function When_I_click_on_label(text: string, options?: DataTable): void; /** * When I click on test ID: * * ```gherkin * When I click on test ID {string} * ``` * * Clicks on the first element with the matching `data-testid` or `data-test-id` attribute: * * ```html * <div data-testid="test"></div> * <div data-test-id="test"></div> * ``` * * _Use this only if the other actions don't work. `data-testid` or `data-test-id` don't resemble how your software is used and should be avoided if possible._ * * @example * * ```gherkin * When I click on test ID "testID" * ``` * * With options: * * ```gherkin * When I click on test ID "testID" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * | withinSubject | null | * ``` * * @see * * - {@link When_I_click_on_text | When I click on text} */ export declare function When_I_click_on_testid(testId: string, options?: DataTable): void; /** * When I click on title: * * ```gherkin * When I click on title {string} * ``` * * Clicks on the first element with the matching title. * * @example * * ```gherkin * When I click on title "Title" * ``` * * With options: * * ```gherkin * When I click on title "Title" * | altKey | false | * | animationDistanceThreshold | 5 | * | ctrlKey | false | * | force | false | * | includeShadowDom | false | * | log | true | * | metaKey | false | * | multiple | false | * | scrollBehavior | top | * | shiftKey | false | * | timeout | 4000 | * | waitForAnimations | true | * | withinSubject | null | * | pseudoSelector | visible | * ``` * * @see * * - {@link When_I_click_on_text | When I click on text} */ export declare function When_I_click_on_title(text: string, options?: DataTable): void; //# sourceMappingURL=click.d.ts.map