@uuv/playwright 2.10.0 → 2.11.0

package/dist/cucumber/step_definitions/playwright/_context.d.ts

@@ -14,6 +14,6 @@
 import { IContext } from "@uuv/runner-commons";
 import { Locator } from "@playwright/test";
 export declare class Context implements IContext {
-    focusedElement?: Locator;
+    withinFocusedElement?: Locator;
     timeout: number | null;
 }

package/dist/cucumber/step_definitions/playwright/_context.js

@@ -16,7 +16,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
 const runner_commons_1 = require("@uuv/runner-commons");
 class Context {
-    focusedElement;
+    withinFocusedElement;
     timeout = runner_commons_1.DEFAULT_TIMEOUT;
 }
 exports.Context = Context;

package/dist/cucumber/step_definitions/playwright/core-engine.d.ts

@@ -14,7 +14,7 @@
 import { World } from "../../preprocessor/run/world";
 import { Cookie, Locator } from "playwright";
 export declare enum COOKIE_NAME {
-    SELECTED_ELEMENT = "selectedElement",
+    SELECTED_ELEMENT = "withinFocusedElement",
     MOCK_URL = "mockUrl"
 }
 export declare enum COOKIE_VALUE {
@@ -46,6 +46,7 @@ export declare function findWithRoleAndName(world: World, role: string, name: st
 export declare function withinRoleAndName(world: World, role: string, name: string): Promise<void>;
 export declare function notFoundWithRoleAndName(world: World, role: string, name: string): Promise<void>;
 export declare function findWithRoleAndNameAndContent(world: World, expectedRole: string, name: string, expectedTextContent?: string | undefined): Promise<any>;
+export declare function findWithRoleAndNameFocused(world: World, expectedRole: string, name: string): Promise<any>;
 export declare function findWithRoleAndNameAndContentDisable(world: World, expectedRole: string, name: string, expectedTextContent: string): Promise<void>;
 export declare function findWithRoleAndNameAndContentEnable(world: World, expectedRole: string, name: string, expectedTextContent: string): Promise<void>;
 export declare function showAttributesInLocator(element: any): Promise<void>;

package/dist/cucumber/step_definitions/playwright/core-engine.js

@@ -13,11 +13,11 @@
  * understanding English or French.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkTextContentLocator = exports.showAttributesInLocator = exports.findWithRoleAndNameAndContentEnable = exports.findWithRoleAndNameAndContentDisable = exports.findWithRoleAndNameAndContent = exports.notFoundWithRoleAndName = exports.withinRoleAndName = exports.findWithRoleAndName = exports.deleteCookieByName = exports.deleteCookieByValue = exports.getCookie = exports.addCookieWhenValueIsList = exports.getPageOrElement = exports.FILTER_TYPE = exports.COOKIE_VALUE = exports.COOKIE_NAME = void 0;
+exports.checkTextContentLocator = exports.showAttributesInLocator = exports.findWithRoleAndNameAndContentEnable = exports.findWithRoleAndNameAndContentDisable = exports.findWithRoleAndNameFocused = exports.findWithRoleAndNameAndContent = exports.notFoundWithRoleAndName = exports.withinRoleAndName = exports.findWithRoleAndName = exports.deleteCookieByName = exports.deleteCookieByValue = exports.getCookie = exports.addCookieWhenValueIsList = exports.getPageOrElement = exports.FILTER_TYPE = exports.COOKIE_VALUE = exports.COOKIE_NAME = void 0;
 const test_1 = require("@playwright/test");
 var COOKIE_NAME;
 (function (COOKIE_NAME) {
-    COOKIE_NAME["SELECTED_ELEMENT"] = "selectedElement";
+    COOKIE_NAME["SELECTED_ELEMENT"] = "withinFocusedElement";
     COOKIE_NAME["MOCK_URL"] = "mockUrl";
 })(COOKIE_NAME = exports.COOKIE_NAME || (exports.COOKIE_NAME = {}));
 var COOKIE_VALUE;
@@ -145,7 +145,6 @@ exports.notFoundWithRoleAndName = notFoundWithRoleAndName;
 async function findWithRoleAndNameAndContent(world, expectedRole, name, expectedTextContent = undefined) {
     expectedRole = encodeURIComponent(expectedRole);
     await getPageOrElement(world).then(async (element) => {
-        // console.log("final:",expectedRole,name)
         const byRole = await element.getByRole(expectedRole, { name: name, includeHidden: true, exact: true });
         await (0, test_1.expect)(byRole).toHaveCount(1);
         if (expectedTextContent !== undefined) {
@@ -154,6 +153,16 @@ async function findWithRoleAndNameAndContent(world, expectedRole, name, expected
     });
 }
 exports.findWithRoleAndNameAndContent = findWithRoleAndNameAndContent;
+async function findWithRoleAndNameFocused(world, expectedRole, name) {
+    expectedRole = encodeURIComponent(expectedRole);
+    await getPageOrElement(world).then(async (element) => {
+        // console.log("final:",expectedRole,name)
+        const byRole = await element.getByRole(expectedRole, { name: name, includeHidden: true, exact: true });
+        await (0, test_1.expect)(byRole).toHaveCount(1);
+        await (0, test_1.expect)(byRole).toBeFocused();
+    });
+}
+exports.findWithRoleAndNameFocused = findWithRoleAndNameFocused;
 async function findWithRoleAndNameAndContentDisable(world, expectedRole, name, expectedTextContent) {
     expectedRole = encodeURIComponent(expectedRole);
     await getPageOrElement(world).then(async (element) => {

package/dist/cucumber/step_definitions/playwright/generated/_en-generated-cucumber-steps-definition.js

@@ -25,70 +25,143 @@ const test_1 = require("@playwright/test");
 const core_engine_1 = require("../core-engine");
 const cucumber_1 = require("@cucumber/cucumber");
 const path_1 = __importDefault(require("path"));
+/**
+ * Sets the viewport dimensions with one of the presets defined by your runtime engine as Cypress: [Link](https://docs.cypress.io/api/commands/viewport#Arguments) or Playwright: [Link](https://github.com/microsoft/playwright/blob/main/packages/playwright-core/src/server/deviceDescriptorsSource.json)
+ * */
 (0, cucumber_1.Given)(`I set viewport to preset {string}`, async function (viewportPreset) {
     await this.page.setViewportSize(test_1.devices[viewportPreset].viewport);
 });
+/**
+ * Sets the viewport dimensions to the specified width and length
+ * */
 (0, cucumber_1.Given)(`I set viewport with width {int} and height {int}`, async function (width, height) {
     await this.page.setViewportSize({ width: width, height: height });
 });
+/**
+ * Start a keyboard navigation session from the top of the page
+ * */
+(0, cucumber_1.Given)(`I start a keyboard navigation from the top of the page`, async function () {
+    await this.page.mouse.click(0.5, 0.5);
+    await this.page.keyboard.press("Tab");
+});
+/**
+ * Navigate to the Uri passed as a argument (full url consisting of the BASE_URL + Uri) or navigate to Url if begin with http:// or https://
+ * */
 (0, cucumber_1.Given)(`I visit path {string}`, { timeout: 60 * 1000 }, async function (siteUrl) {
     await (0, core_engine_1.deleteCookieByName)(this, core_engine_1.COOKIE_NAME.SELECTED_ELEMENT);
     await this.page.goto(`${siteUrl}`);
 });
+/**
+ * Triggers a click on the selected element.<br/>Make sure you've selected an element beforehand with the <strong>within...</strong> phrases.
+ * */
 (0, cucumber_1.When)(`I click`, async function () {
-    await (0, core_engine_1.getPageOrElement)(this).then((element) => element.click({ timeout: runner_commons_1.DEFAULT_TIMEOUT }));
+    const keyBoardFocusTargetObj = keyBoardFocusTarget(this);
+    if ((await keyBoardFocusTargetObj.count()) === 1) {
+        await keyBoardFocusTargetObj.click({ timeout: runner_commons_1.DEFAULT_TIMEOUT });
+    }
+    else {
+        await (0, core_engine_1.getPageOrElement)(this).then((element) => element.click({ timeout: runner_commons_1.DEFAULT_TIMEOUT }));
+    }
 });
+/**
+ * Triggers a click on the given button with specific name
+ * */
 (0, cucumber_1.When)(`I click on button named {string}`, async function (name) {
     await click(this, "button", name);
 });
+/**
+ * Triggers a click on the element with given role and specific name
+ * */
 (0, cucumber_1.When)(`I click on element with role {string} and name {string}`, async function (role, name) {
     await click(this, role, name);
 });
 // TODO : permet de gérer les label accessibles donc pas que les aria : https://playwright.dev/docs/api/class-locator#locator-get-by-label
+/**
+ * Selects the element whose aria-label is specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 (0, cucumber_1.When)(`within the element with aria-label {string}`, async function (expectedAriaLabel) {
     const sanitizedExpectedAriaLabel = encodeURIComponent(expectedAriaLabel).replaceAll("%20", " ");
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByLabel(sanitizedExpectedAriaLabel, { exact: true })).toHaveCount(1));
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.SELECTED_ELEMENT, { name: core_engine_1.FILTER_TYPE.ARIA_LABEL, value: sanitizedExpectedAriaLabel });
 });
+/**
+ * Deletes selected element and timeout
+ * */
 (0, cucumber_1.When)(`I reset context`, async function () {
     await this.context.clearCookies();
 });
+/**
+ * Selects the element whose selector is specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 (0, cucumber_1.When)(`within the element with selector {string}`, async function (selector) {
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.locator(selector)).toHaveCount(1));
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.SELECTED_ELEMENT, { name: core_engine_1.FILTER_TYPE.SELECTOR, value: selector });
 });
+/**
+ * Writes the sentence passed as a parameter (useful for example to fill in a form field).<br/>Make sure you've selected an element beforehand with the <strong>within...</strong> phrases.
+ * */
 (0, cucumber_1.When)(`I type the sentence {string}`, async function (textToType) {
-    await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
-        await element.focus({ timeout: 10000 });
-        await element.type(textToType);
-        // console.debug(await showAttributesInLocator(element));
-    });
-});
-(0, cucumber_1.When)(`I press {int} times on {string}`, async function (nbTimes, key) {
-    for (let i = 1; i <= nbTimes; i++) {
+    const keyBoardFocusTargetObj = keyBoardFocusTarget(this);
+    if ((await keyBoardFocusTargetObj.count()) === 1) {
+        await keyBoardFocusTargetObj.type(textToType);
+    }
+    else {
         await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
+            // console.debug(element);
             await element.focus({ timeout: 10000 });
-            await pressKey(this, element, key);
+            await element.type(textToType);
         });
     }
 });
+/**
+ * Press specified key multiple times using | as: num|{key}
+ * */
+(0, cucumber_1.When)(`I press {int} times on {string}`, async function (nbTimes, key) {
+    for (let i = 1; i <= nbTimes; i++) {
+        await pressKey(this, key);
+    }
+});
+/**
+ * Press specified key: <table><thead><tr><th>Key</th><th>Description</th></tr></thead><tbody><tr><td>{tab}</td><td>Tabulation</td></tr><tr><td>{reverseTab}</td><td>Reverse tabulation</td></tr><tr><td>{down}</td><td>Arrow Down</td></tr><tr><td>{right}</td><td>Arrow Right</td></tr><tr><td>{left}</td><td>Arrow Left</td></tr><tr><td>{up}</td><td>Arrow Up</td></tr></tbody></table><br/>Make sure you've selected an element beforehand with the <strong>within...</strong> phrases.
+ * */
 (0, cucumber_1.When)(`I press {string}`, async function (key) {
-    await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
-        await element.focus({ timeout: 10000 });
-        await pressKey(this, element, key);
-    });
+    await pressKey(this, key);
+});
+/**
+ * Move to the previous html element that can be reached with back Tab
+ * */
+(0, cucumber_1.When)(`I go to previous keyboard element`, async function () {
+    await this.page.keyboard.press("ShiftLeft+Tab");
+});
+/**
+ * Move to the next html element that can be reached with Tab
+ * */
+(0, cucumber_1.When)(`I go to next keyboard element`, async function () {
+    await this.page.keyboard.press("Tab");
 });
+/**
+ * Sets the timeout value (in millisecond) for finding element in the DOM <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 (0, cucumber_1.When)(`I set timeout with value {int}`, async function (newTimeout) {
     await this.testInfo.setTimeout(newTimeout);
 });
+/**
+ * Selects the element whose [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and accessible [name](https://russmaxdesign.github.io/html-elements-names/) are specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 (0, cucumber_1.When)(`within the element with role {string} and name {string}`, async function (role, name) {
     await (0, core_engine_1.withinRoleAndName)(this, role, name);
 });
+/**
+ * Selects the element whose data-testId attribute is specified <br />⚠ remember to deselect the element with <b>[I reset context](#i-reset-context)</b> if you're no longer acting on it
+ * */
 (0, cucumber_1.When)(`within the element with testId {string}`, async function (testId) {
     testId = encodeURIComponent(testId);
     await (0, core_engine_1.getPageOrElement)(this).then(async (element) => await (0, test_1.expect)(element.getByTestId(testId)).toHaveCount(1));
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.SELECTED_ELEMENT, { name: core_engine_1.FILTER_TYPE.TEST_ID, value: testId });
 });
+/**
+ * Mock a named API response with body. <i>If you use Playwright as runtime engine, <b>request</b> and <b>named</b> are unused.</i>
+ * */
 (0, cucumber_1.When)(`I mock a request {} on url {string} named {string} with content {}`, async function (verb, url, name, body) {
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.MOCK_URL, { name: name, url: url });
     await this.page.route(url, async (route) => {
@@ -96,12 +169,18 @@ const path_1 = __importDefault(require("path"));
         await route.fulfill({ json });
     });
 });
+/**
+ * Mock a named API response with status code
+ * */
 (0, cucumber_1.When)(`I mock a request {} on url {string} named {string} with status code {int}`, async function (verb, url, name, statusCode) {
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.MOCK_URL, { name: name, url: url });
     await this.page.route(url, async (route) => {
         await route.fulfill({ status: statusCode });
     });
 });
+/**
+ * Mock a named API response with file's extension .json, .js, .coffee, .html, .txt, .csv, .png, .jpg, .jpeg, .gif, .tif, .tiff, .zip
+ * */
 (0, cucumber_1.When)(`I mock a request {} on url {string} named {string} with fixture {}`, async function (verb, url, name, fixture) {
     await (0, core_engine_1.addCookieWhenValueIsList)(this, core_engine_1.COOKIE_NAME.MOCK_URL, { name: name, url: url });
     const data = await runner_commons_1.fs.readFileSync(path_1.default.join(getConfigDir(), `playwright/fixtures/${fixture}`));
@@ -109,43 +188,73 @@ const path_1 = __importDefault(require("path"));
         await route.fulfill({ body: data });
     });
 });
+/**
+ * Checks that an Html element exists with the specified selector
+ * */
 (0, cucumber_1.Then)(`I should see an element with selector {string}`, async function (selector) {
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.locator(selector)).toHaveCount(1));
 });
+/**
+ * Sets one or more headers to the indicated http request and only for the Http method (GET / POST / etc...) passed as a argument.<i> If you use Playwright as execution engine, <b>method</b> isn't used.</i>
+ * */
 (0, cucumber_1.When)(`I set header(s) for uri {string} and method {string}`, async function (url, method, headersToSet) {
     await this.page.route(url, async (route) => {
         const headers = route.request().headers();
         await route.continue({ headers: { ...headers, ...headersToSet.rowsHash() } });
     });
 });
+/**
+ * Sets one or more headers to the indicated http request
+ * */
 (0, cucumber_1.When)(`I set header(s) for uri {string}`, async function (url, headersToSet) {
     await this.page.route(url, async (route) => {
         const headers = route.request().headers();
         await route.continue({ headers: { ...headers, ...headersToSet.rowsHash() } });
     });
 });
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 (0, cucumber_1.Then)(`I should see an element with role {string} and name {string}`, async function (role, name) {
     await (0, core_engine_1.findWithRoleAndName)(this, role, name);
 });
+/**
+ * Checks that an Html element exists with the specified content
+ * */
 (0, cucumber_1.Then)(`I should see an element with content {string}`, async function (textContent) {
     // TODO partie pris de faire en exactitude. A voir si on doit faire 2 phrases https://playwright.dev/docs/api/class-locator#locator-get-by-text
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByText(textContent, { exact: true })).toHaveCount(1));
 });
+/**
+ * Checks that an Html element does not exists with the specified content
+ * */
 (0, cucumber_1.Then)(`I should not see an element with content {string}`, async function (textContent) {
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByText(textContent, { exact: true })).toHaveCount(0));
 });
+/**
+ * Checks that an Html element exists with the specified data-testid attribute
+ * */
 (0, cucumber_1.Then)(`I should see an element with testId {string}`, async function (testId) {
     testId = encodeURIComponent(testId);
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByTestId(testId, { exact: true })).toHaveCount(1));
 });
+/**
+ * Checks that an Html element does not exists with the specified data-testid attribute
+ * */
 (0, cucumber_1.Then)(`I should not see an element with testId {string}`, async function (testId) {
     testId = encodeURIComponent(testId);
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByTestId(testId, { exact: true })).toHaveCount(0));
 });
+/**
+ * Check that the current page have no accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core accessibility issue`, async function () {
     await (0, axe_playwright_1.injectAxe)(this.page);
     await (0, axe_playwright_1.checkA11y)(this.page);
 });
+/**
+ * Check that the current page have no accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [with an option](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#options-parameter)
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core accessibility issue with option json fixture {}`, async function (option) {
     await (0, axe_playwright_1.injectAxe)(this.page);
     const optionFile = await runner_commons_1.fs.readFileSync(path_1.default.join(getConfigDir(), `playwright/fixtures/${option}`));
@@ -158,6 +267,9 @@ function getConfigDir() {
     // eslint-disable-next-line dot-notation
     return process.env["CONFIG_DIR"] ? process.env["CONFIG_DIR"] : "";
 }
+/**
+ * Check that the current page have no accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [with an option](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#options-parameter) on the specific [context](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#context-parameter)
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core accessibility issue with context json fixture {} and option json fixture {}`, async function (context, option) {
     await (0, axe_playwright_1.injectAxe)(this.page);
     const contextFile = await runner_commons_1.fs.readFileSync(path_1.default.join(getConfigDir(), `playwright/fixtures/${context}`));
@@ -167,18 +279,27 @@ function getConfigDir() {
         axeOptions: optionJson
     });
 });
+/**
+ * Check that the current page have not critical accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core critical accessibility issue`, async function () {
     await (0, axe_playwright_1.injectAxe)(this.page);
     await (0, axe_playwright_1.checkA11y)(this.page, undefined, {
         includedImpacts: ["critical"]
     });
 });
+/**
+ * Check that the current page have not accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) with one or more impacts in: 'minor','moderate','serious','critical'
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core accessibility issue with {} impact(s)`, async function (impacts) {
     await (0, axe_playwright_1.injectAxe)(this.page);
     await (0, axe_playwright_1.checkA11y)(this.page, undefined, {
         includedImpacts: [impacts]
     });
 });
+/**
+ * Check that the current page have not accessibility issue for [axe-core](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) [with one or more Accessibility Standards](https://github.com/dequelabs/axe-core/blob/HEAD/doc/API.md#axe-core-tags)
+ * */
 (0, cucumber_1.Then)(`I should not have any axe-core accessibility issue with accessibility standard(s) {}`, async function (tags) {
     await (0, axe_playwright_1.injectAxe)(this.page);
     await (0, axe_playwright_1.checkA11y)(this.page, undefined, {
@@ -190,26 +311,53 @@ function getConfigDir() {
         }
     });
 });
+/**
+ * Checks that an Html element does not exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/)
+ * */
 (0, cucumber_1.Then)(`I should not see an element with role {string} and name {string}`, async function (role, name) {
     await (0, core_engine_1.notFoundWithRoleAndName)(this, role, name);
 });
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content
+ * */
 (0, cucumber_1.Then)(`I should see an element with role {string} and name {string} and content {string}`, async function (expectedRole, name, expectedTextContent) {
     await (0, core_engine_1.findWithRoleAndNameAndContent)(this, expectedRole, name, expectedTextContent);
 });
+/**
+ * Checks that the Html element with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types) and [name](https://russmaxdesign.github.io/html-elements-names/) is focused
+ * */
+(0, cucumber_1.Then)(`the element with role {string} and name {string} should be keyboard focused`, async function (expectedRole, name) {
+    await (0, core_engine_1.findWithRoleAndNameFocused)(this, expectedRole, name);
+});
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to true
+ * */
 (0, cucumber_1.Then)(`I should see an element with role {string} and name {string} and content {string} disabled`, async function (expectedRole, name, expectedTextContent) {
     await (0, core_engine_1.findWithRoleAndNameAndContentDisable)(this, expectedRole, name, expectedTextContent);
 });
+/**
+ * Checks that an Html element exists with the specified [accessible role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles#aria_role_types), [name](https://russmaxdesign.github.io/html-elements-names/) and content, and with the disabled attribute set to false
+ * */
 (0, cucumber_1.Then)(`I should see an element with role {string} and name {string} and content {string} not disabled`, async function (expectedRole, name, expectedTextContent) {
     await (0, core_engine_1.findWithRoleAndNameAndContentEnable)(this, expectedRole, name, expectedTextContent);
 });
+/**
+ * Checks that an Html element exists with the specified aria-label attribute
+ * */
 (0, cucumber_1.Then)(`I should see an element with aria-label {string}`, async function (expectedAriaLabel) {
     expectedAriaLabel = encodeURIComponent(expectedAriaLabel);
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByLabel(expectedAriaLabel, { exact: true })).toHaveCount(1));
 });
+/**
+ * Checks that an Html element does not exists with the specified aria-label attribute
+ * */
 (0, cucumber_1.Then)(`I should not see an element with aria-label {string}`, async function (expectedAriaLabel) {
     expectedAriaLabel = encodeURIComponent(expectedAriaLabel);
     await (0, core_engine_1.getPageOrElement)(this).then((element) => (0, test_1.expect)(element.getByLabel(expectedAriaLabel, { exact: true })).toHaveCount(0));
 });
+/**
+ * Checks that an Html element exists with the specified aria-label attribute and content
+ * */
 (0, cucumber_1.Then)(`I should see an element with aria-label {string} and content {string}`, async function (expectedAriaLabel, expectedTextContent) {
     expectedAriaLabel = encodeURIComponent(expectedAriaLabel);
     await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
@@ -218,6 +366,9 @@ function getConfigDir() {
         await (0, test_1.expect)(byLabel.filter({ hasText: expectedTextContent })).toHaveCount(1);
     });
 });
+/**
+ * Wait that a named mock has been consumed until timeout
+ * */
 (0, cucumber_1.Then)(`I should consume a mock named {string}`, async function (name) {
     const cookie = await (0, core_engine_1.getCookie)(this, core_engine_1.COOKIE_NAME.MOCK_URL);
     const mockUrls = JSON.parse(cookie.value);
@@ -228,10 +379,15 @@ function getConfigDir() {
     await (0, core_engine_1.deleteCookieByValue)(this, core_engine_1.COOKIE_NAME.MOCK_URL, mockUrl);
     // console.debug("request: ", request);
 });
-//
+/**
+ * Wait milliseconds. <b>Warning:</b> use this sentence <b>in production</b> can make your <b>test flaky</b>.
+ * */
 (0, cucumber_1.Then)(`I wait {int} ms`, async function (ms) {
     await this.page.waitForTimeout(ms);
 });
+/**
+ * Checks Html attributes of the selected element
+ * */
 (0, cucumber_1.Then)(`I should see these attributes with values`, async function (expectedAttributeList) {
     await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
         // console.debug("expectedAttributeList.raw(),", expectedAttributeList.raw())
@@ -243,6 +399,9 @@ function getConfigDir() {
         }
     });
 });
+/**
+ * Checks that there is a list with the specified [name](https://russmaxdesign.github.io/html-elements-names/) containing list items.<br/> <u>Example</u>\n```gherkin\nThen I should see a list named "test-list" and containing\n| First element   |\n| Second element  |\n| Third element   |\n```
+ * */
 (0, cucumber_1.Then)(`I should see a list named {string} and containing`, async function (expectedListName, expectedElementsOfList) {
     await (0, core_engine_1.withinRoleAndName)(this, "list", expectedListName);
     await (0, core_engine_1.getPageOrElement)(this).then(async (element) => {
@@ -258,25 +417,25 @@ function getConfigDir() {
         await (0, test_1.expect)(foundedElement).toEqual(expectedElementsOfList.raw());
     });
 });
-async function pressKey(world, element, key) {
+async function pressKey(world, key) {
     switch (key) {
         case runner_commons_1.KEY_PRESS.TAB:
-            await element.press("Tab");
+            await world.page.keyboard.press("Tab");
             break;
         case runner_commons_1.KEY_PRESS.REVERSE_TAB:
-            await element.press("ShiftLeft+Tab");
+            await world.page.keyboard.press("ShiftLeft+Tab");
             break;
         case runner_commons_1.KEY_PRESS.UP:
-            await element.press("ArrowUp");
+            await world.page.keyboard.press("ArrowUp");
             break;
         case runner_commons_1.KEY_PRESS.DOWN:
-            await element.press("ArrowDown");
+            await world.page.keyboard.press("ArrowDown");
             break;
         case runner_commons_1.KEY_PRESS.LEFT:
-            await element.press("ArrowLeft");
+            await world.page.keyboard.press("ArrowLeft");
             break;
         case runner_commons_1.KEY_PRESS.RIGHT:
-            await element.press("ArrowRight");
+            await world.page.keyboard.press("ArrowRight");
             break;
         default:
             console.error("the command" + key + " is unrecognized.");
@@ -293,3 +452,6 @@ async function click(world, role, name) {
         await world.context.clearCookies();
     });
 }
+function keyBoardFocusTarget(world) {
+    return world.page.locator(":focus");
+}