codeceptjs 2.6.1 → 2.6.2

package/docs/reports.md

@@ -199,6 +199,18 @@ Allure reports can also be generated for `dry-run` command. So you can get the f
 npx codeceptjs dry-run --debug -p allure
 ```
 
+## ReportPortal
+
+Allure is a great reportin tool, however, if you are running tests on different machines it is hard to merge its XML result files to build a proper report. So, for enterprise grade reporting we recommend using [ReportPortal](https://reportportal.io).
+
+![](https://camo.githubusercontent.com/6550c0365f1d0ce1e29c53f1860b12957d1fc529/68747470733a2f2f692e6962622e636f2f516d353247306e2f53637265656e73686f742d323031392d30342d31312d61742d31352d35372d34302e706e67)
+
+[ReportPortal](https://reportportal.io) is open-source self-hosted service for aggregating test execution reports.
+Think of it as Kibana but for test reports.
+
+Use official [CodeceptJS Agent for ReportPortal](https://github.com/reportportal/agent-js-codecept/) to start publishing your test results.
+
+
 ## XML
 
 Use default xunit reporter of Mocha to print xml reports. Provide `--reporter xunit` to get the report to screen.

package/docs/visual.md

@@ -112,79 +112,6 @@ MisMatch Percentage Calculated is 2.85
 1) `seeVisualDiff` which can be used to compare two images and calculate the misMatch percentage.
 2) `seeVisualDiffForElement` which can be used to compare elements on the two images and calculate misMatch percentage.
 
-## Using Visual Knight
-
-Visual Knight is a SaaS product which strongly supports CodeceptJS with multiple use cases. It provides an user interface to handle mismatches, statistics and more. It was designed to support Designer, Product Owner and other roles which are not familiar with coding and all this tools. All captured images are saved in a secure cloud system to not mess up your git repository.
-
-### Setup
-
-Create an account at [Visual Knight](https://www.visual-knight.io) and install the npm package
-
-```
-npm install @visual-knight/codeceptjs -D
-```
-
-### Configuring
-
-```json
-{
-    "helpers": {
-        "VisualKnight": {
-            "require": "@visual-knight/codeceptjs",
-            "key": "YOUR_API_KEY",
-            "project": "YOUR_PROJECT_ID OR PROJECT_NAME"
-        }
-    }
-}
-```
-
-### Usage
-
-```javascript
-/**
- * @param testName {string} Is provided to visual knight (must be unique)
- * @param options {ScreenshotOptions} Contains additional settings
- */
-I.compareFullpageScreenshot(testName, options)
-/**
- * @param testName {string} Is provided to visual knight (must be unique)
- * @param options {ScreenshotOptions} Contains additional settings
- */
-I.compareViewportScreenshot(testName, options)
-/**
- * @param cssSelector {string} Is provided to visual knight
- * @param testName {string} Is provided to visual knight (must be unique)
- * @param options {ScreenshotOptions} Contains additional settings
- */
-I.compareElementScreenshot(cssSelector, testName, options)
-
-/*
-ScreenshotOptions {
-  hide?: string[] // Array of css selectors which gets hidden by "opacity: 0",
-  remove?: string[] // Array of css selectors which gets hidden by "display: none",
-  additional?: object // Data is saved as relation to the variation. (Future: can be used for filtering)
-}
-*/
-```
-
-> You can find the latest documentation here [CodeceptJS helper page](https://doc.visual-knight.io/adapters/codeceptjs)
-
-### Example
-
-Lets consider visual testing for [CodeceptJS Home](http://codecept.io)
-
-```js
-Feature('To test screen comparison with Visual Knight Example test');
-
-Scenario('Compare CodeceptIO Home Page @visual-test', async (I, adminPage) => {
-    I.amOnPage("/");
-    I.compareFullpageScreenshot("CodeceptIO Home Page")
-});
-```
-
-Depending of your configuration this test will fail if no baseline exists and log the link to the image to accept or automatically accept the first run as baseline.
-> You can accept the first image as baseline automatically via ```autoBaseline: true``` _default is false_
-
 ## Using Applitools
 
 Applitools helps Test Automation engineers, DevOps, and FrontEnd Developers continuously test and validate visually perfect mobile, web, and native apps. Now it can be used with CodeceptJS.

package/docs/webapi/forceClick.mustache

@@ -0,0 +1,27 @@
+Perform an emulated click on a link or a button, given by a locator.
+Unlike normal click instead of sending native event, emulates a click with JavaScript.
+This works on hidden, animated or inactive elements as well.
+
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
+```js
+// simple link
+I.forceClick('Logout');
+// button of form
+I.forceClick('Submit');
+// CSS button
+I.forceClick('#form input[type=submit]');
+// XPath
+I.forceClick('//form/*[@type=submit]');
+// link in context
+I.forceClick('Logout', '#nav');
+// using strict locator
+I.forceClick({css: 'nav a.login'});
+```
+
+@param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+@param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.

package/docs/webdriver.md

@@ -53,6 +53,8 @@ exports.config = {
 }
 ```
 
+> ⚠ It is not recommended to use wdio plugin & selenium-standalone when running tests in parallel. Consider **switching to Selenoid** if you need parallel run or using cloud services.
+
 
 ## Configuring WebDriver
 
@@ -104,7 +106,7 @@ path: '/',
 
 > If you face issues connecting to WebDriver, please check that corresponding server is running on a specified port. If host is other than `localhost` or port is other than `4444`, update the configuration.
 
-### Selenium in Docker
+### Selenium in Docker (Selenoid)
 
 Browsers can be executed in Docker containers. This is useful when testing on Continous Integration server.
 We recommend using [Selenoid](https://aerokube.com/selenoid/) to run browsers in container.

package/lib/command/run-workers.js

@@ -101,10 +101,11 @@ module.exports = function (workers, options) {
 
       switch (message.event) {
         case event.test.failed:
-          updateFinishedTests(repackTest(message.data), maxReruns);
           output.test.failed(repackTest(message.data));
+          updateFinishedTests(repackTest(message.data), maxReruns);
           break;
-        case event.test.passed: output.test.passed(repackTest(message.data));
+        case event.test.passed:
+          output.test.passed(repackTest(message.data));
           updateFinishedTests(repackTest(message.data), maxReruns);
           break;
         case event.suite.before: output.suite.started(message.data); break;
@@ -232,11 +233,13 @@ function simplifyObject(object) {
 const updateFinishedTests = (test, maxReruns) => {
   const { id } = test;
   if (finishedTests[id]) {
-    const stats = { passes: 0, failures: -1, tests: 0 };
     if (finishedTests[id].runs <= maxReruns) {
       finishedTests[id].runs++;
     }
-    appendStats(stats);
+    if (test.retries !== -1) {
+      const stats = { passes: 0, failures: -1, tests: 0 };
+      appendStats(stats);
+    }
   } else {
     finishedTests[id] = test;
     finishedTests[id].runs = 1;

package/lib/command/workers/runTests.js

@@ -80,6 +80,7 @@ function initializeListeners() {
     return {
       id: test.id,
       workerIndex,
+      retries: test._retries,
       title: test.title,
       status: test.status,
       duration: test.duration || 0,

package/lib/event.js

@@ -24,6 +24,7 @@ module.exports = {
    * @property {'test.passed'} passed
    * @property {'test.failed'} failed
    * @property {'test.finish'} finished
+   * @property {'test.skipped'} skipped
    */
   test: {
     started: 'test.start', // sync
@@ -32,6 +33,7 @@ module.exports = {
     passed: 'test.passed', // sync
     failed: 'test.failed', // sync
     finished: 'test.finish', // sync
+    skipped: 'test.skipped', // sync
   },
   /**
    * @type {object}

package/lib/helper/Playwright.js

@@ -1,5 +1,7 @@
 const requireg = require('requireg');
 const path = require('path');
+const fs = require('fs');
+const fsExtra = require('fs-extra');
 
 const Helper = require('../helper');
 const Locator = require('../locator');
@@ -69,7 +71,7 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * * `keepBrowserState`: (optional, default: false) - keep browser state between tests when `restart` is set to false.
  * * `keepCookies`: (optional, default: false) - keep cookies between tests when `restart` is set to false.
  * * `waitForAction`: (optional) how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
- * * `waitForNavigation`: (optional, default: 'load'). When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Playwright API](https://github.com/GoogleChrome/Playwright/blob/master/docs/api.md#pagewaitfornavigationoptions). Array values are accepted as well.
+ * * `waitForNavigation`: (optional, default: 'load'). When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. Choose one of those options is possible. See [Playwright API](https://github.com/microsoft/playwright/blob/master/docs/api.md#pagewaitfornavigationoptions).
  * * `pressKeyDelay`: (optional, default: '10'). Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
  * * `getPageTimeout` (optional, default: '0') config option to set maximum navigation time in milliseconds.
  * * `waitForTimeout`: (optional) default wait* timeout in ms. Default: 1000.
@@ -94,7 +96,7 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * }
  * ```
  *
- * #### Example #2: Wait for DOMContentLoaded event and 0 network connections
+ * #### Example #2: Wait for DOMContentLoaded event
  *
  * ```js
  * {
@@ -102,7 +104,7 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  *      Playwright : {
  *        url: "http://localhost",
  *        restart: false,
- *        waitForNavigation: [ "domcontentloaded", "networkidle0" ],
+ *        waitForNavigation: "domcontentloaded",
  *        waitForAction: 500
  *      }
  *    }
@@ -533,7 +535,7 @@ class Playwright extends Helper {
     this.browser.on('targetchanged', (target) => {
       this.debugSection('Url', target.url());
     });
-    this.browserContext = await this.browser.newContext(this.options.emulate);
+    this.browserContext = await this.browser.newContext({ acceptDownloads: true, ...this.options.emulate });
 
     const existingPages = await this.browserContext.pages();
 
@@ -993,6 +995,36 @@ class Playwright extends Helper {
     return empty('elements on a page').assert(els.filter(v => v).fill('ELEMENT'));
   }
 
+  /**
+   * Handles a file download.Aa file name is required to save the file on disk.
+   * Files are saved to "output" directory.
+   *
+   * Should be used with [FileSystem helper](https://codecept.io/helpers/FileSystem) to check that file were downloaded correctly.
+   *
+   * ```js
+   * I.handleDownloads('downloads/avatar.jpg');
+   * I.click('Download Avatar');
+   * I.amInPath('output/downloads');
+   * I.waitForFile('downloads/avatar.jpg', 5);
+   *
+   * ```
+   *
+   * @param {string} [fileName] set filename for downloaded file
+   */
+  async handleDownloads(fileName = 'downloads') {
+    this.page.waitForEvent('download').then(async (download) => {
+      const filePath = await download.path();
+      const downloadPath = path.join(global.output_dir, fileName || path.basename(filePath));
+      if (!fs.existsSync(path.dirname(downloadPath))) {
+        fs.mkdirSync(path.dirname(downloadPath), '0777');
+      }
+      fs.copyFileSync(filePath, downloadPath);
+      this.debug('Download completed');
+      this.debugSection('Downloaded From', await download.url());
+      this.debugSection('Downloaded To', downloadPath);
+    });
+  }
+
   /**
    * {{> click }}
    *

package/lib/helper/Puppeteer.js

@@ -232,7 +232,7 @@ class Puppeteer extends Helper {
     try {
       requireg('puppeteer');
     } catch (e) {
-      return ['puppeteer@^1.6.0'];
+      return ['puppeteer@^3.0.1'];
     }
   }
 
@@ -943,6 +943,36 @@ class Puppeteer extends Helper {
     return proceedClick.call(this, locator, context);
   }
 
+  /**
+   * {{> forceClick }}
+   *
+   * {{ react }}
+   */
+  async forceClick(locator, context = null) {
+    let matcher = await this.context;
+    if (context) {
+      const els = await this._locate(context);
+      assertElementExists(els, context);
+      matcher = els[0];
+    }
+
+    const els = await findClickable.call(this, matcher, locator);
+    if (context) {
+      assertElementExists(els, locator, 'Clickable element', `was not found inside element ${new Locator(context).toString()}`);
+    } else {
+      assertElementExists(els, locator, 'Clickable element');
+    }
+    const elem = els[0];
+    return this.executeScript((el) => {
+      if (document.activeElement instanceof HTMLElement) {
+        document.activeElement.blur();
+      }
+      const event = document.createEvent('MouseEvent');
+      event.initEvent('click', true, true);
+      return el.dispatchEvent(event);
+    }, elem);
+  }
+
   /**
    * {{> clickLink }}
    *

package/lib/helper/WebDriver.js

@@ -516,6 +516,11 @@ class WebDriver extends Helper {
       if (this.options.multiremote) {
         this.browser = await webdriverio.multiremote(this.options.multiremote);
       } else {
+        // remove non w3c capabilities
+        delete this.options.capabilities.protocol;
+        delete this.options.capabilities.hostname;
+        delete this.options.capabilities.port;
+        delete this.options.capabilities.path;
         this.browser = await webdriverio.remote(this.options);
       }
     } catch (err) {
@@ -765,13 +770,15 @@ class WebDriver extends Helper {
    * Find a clickable element by providing human readable text:
    *
    * ```js
-   * this.helpers['WebDriver']._locateClickable('Next page').then // ...
+   * const els = await this.helpers.WebDriver._locateClickable('Next page');
+   * const els = await this.helpers.WebDriver._locateClickable('Next page', '.pages');
    * ```
    *
    * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
    */
-  async _locateClickable(locator) {
-    return findClickable.call(this, locator, this.$$.bind(this)).then(res => res);
+  async _locateClickable(locator, context) {
+    const locateFn = prepareLocateFn.call(this, context);
+    return findClickable.call(this, locator, locateFn);
   }
 
   /**
@@ -842,6 +849,32 @@ class WebDriver extends Helper {
     return this.browser[clickMethod](getElementId(elem));
   }
 
+  /**
+   * {{> forceClick }}
+   *
+   * {{ react }}
+   */
+  async forceClick(locator, context = null) {
+    const locateFn = prepareLocateFn.call(this, context);
+
+    const res = await findClickable.call(this, locator, locateFn);
+    if (context) {
+      assertElementExists(res, locator, 'Clickable element', `was not found inside element ${new Locator(context)}`);
+    } else {
+      assertElementExists(res, locator, 'Clickable element');
+    }
+    const elem = usingFirstElement(res);
+
+    return this.executeScript((el) => {
+      if (document.activeElement instanceof HTMLElement) {
+        document.activeElement.blur();
+      }
+      const event = document.createEvent('MouseEvent');
+      event.initEvent('click', true, true);
+      return el.dispatchEvent(event);
+    }, elem);
+  }
+
   /**
    * {{> doubleClick }}
    *
@@ -1859,6 +1892,19 @@ class WebDriver extends Helper {
    */
   async waitForEnabled(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeout;
+    if (isWebDriver5()) {
+      return this.browser.waitUntil(async () => {
+        const res = await this.$$(withStrictLocator(locator));
+        if (!res || res.length === 0) {
+          return false;
+        }
+        const selected = await forEachAsync(res, async el => this.browser.isElementEnabled(getElementId(el)));
+        if (Array.isArray(selected)) {
+          return selected.filter(val => val === true).length > 0;
+        }
+        return selected;
+      }, aSec * 1000, `element (${new Locator(locator)}) still not enabled after ${aSec} sec`);
+    }
     return this.browser.waitUntil(async () => {
       const res = await this.$$(withStrictLocator(locator));
       if (!res || res.length === 0) {
@@ -1869,7 +1915,10 @@ class WebDriver extends Helper {
         return selected.filter(val => val === true).length > 0;
       }
       return selected;
-    }, aSec * 1000, `element (${new Locator(locator)}) still not enabled after ${aSec} sec`);
+    }, {
+      timeout: aSec * 1000,
+      timeoutMsg: `element (${new Locator(locator)}) still not enabled after ${aSec} sec`,
+    });
   }
 
   /**

package/lib/plugin/allure.js

@@ -72,6 +72,7 @@ const defaultConfig = {
  *
  */
 module.exports = (config) => {
+  defaultConfig.outputDir = global.output_dir;
   config = Object.assign(defaultConfig, config);
 
   const plugin = {};

package/lib/plugin/wdio.js

@@ -1,4 +1,6 @@
 const debug = require('debug')('codeceptjs:plugin:wdio');
+const path = require('path');
+const fs = require('fs');
 
 const container = require('../container');
 const mainConfig = require('../config');
@@ -99,7 +101,14 @@ module.exports = (config) => {
     if (Service) {
       if (Service.launcher && typeof Service.launcher === 'function') {
         const Launcher = Service.launcher;
-        launchers.push(new Launcher(config));
+
+        const version = JSON.parse(fs.readFileSync(path.join(require.resolve('webdriverio'), '/../../', 'package.json')).toString()).version;
+        if (version.indexOf('5') === 0) {
+          launchers.push(new Launcher(config));
+        } else {
+          const options = { logPath: global.output_dir, installArgs: {}, args: {} };
+          launchers.push(new Launcher(options, [config.capabilities], config));
+        }
       }
       if (typeof Service === 'function') {
         services.push(new Service(config, config.capabilities));

package/lib/reporter/cli.js

@@ -11,11 +11,11 @@ class Cli extends Base {
   constructor(runner, opts) {
     super(runner);
     let level = 0;
+    this.failedTests = [];
     opts = opts.reporterOptions || opts;
     if (opts.steps) level = 1;
     if (opts.debug) level = 2;
     if (opts.verbose) level = 3;
-
     output.level(level);
     output.print(`CodeceptJS v${require('../codecept').version()}`);
     output.print(`Using test root "${global.codecept_dir}"`);
@@ -42,6 +42,9 @@ class Cli extends Base {
     });
 
     runner.on('fail', (test, err) => {
+      if (test.ctx.currentTest) {
+        this.failedTests.push(test.ctx.currentTest.id);
+      }
       if (showSteps && test.steps) {
         return output.scenario.failed(test);
       }
@@ -90,6 +93,24 @@ class Cli extends Base {
       });
     }
 
+    runner.on('suite end', suite => {
+      let skippedCount = 0;
+      const grep = runner._grep;
+      for (const test of suite.tests) {
+        if (!test.state && !this.failedTests.includes(test.id)) {
+          if (matchTest(grep, test.title)) {
+            event.emit(event.test.skipped, test);
+            test.state = 'skipped';
+            output.test.skipped(test);
+            skippedCount += 1;
+          }
+        }
+      }
+
+      this.stats.pending += skippedCount;
+      this.stats.tests += skippedCount;
+    });
+
     runner.on('end', this.result.bind(this));
   }
 
@@ -129,6 +150,14 @@ class Cli extends Base {
     output.result(stats.passes, stats.failures, stats.pending, ms(stats.duration));
   }
 }
+
+function matchTest(grep, test) {
+  if (grep) {
+    return grep.test(test);
+  }
+  return true;
+}
+
 module.exports = function (runner, opts) {
   return new Cli(runner, opts);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "2.6.1",
+  "version": "2.6.2",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -82,6 +82,7 @@
   },
   "devDependencies": {
     "@codeceptjs/detox-helper": "^1.0.2",
+    "@codeceptjs/mock-request": "^0.3.0",
     "@pollyjs/adapter-puppeteer": "^2.6.3",
     "@pollyjs/core": "^2.6.3",
     "@types/inquirer": "^0.0.35",
@@ -109,9 +110,9 @@
     "mocha-parallel-tests": "^2.2.2",
     "nightmare": "^3.0.2",
     "nodemon": "^1.19.4",
-    "playwright": "^0.12.1",
+    "playwright": "^0.14.0",
     "protractor": "^5.4.1",
-    "puppeteer": "^1.20.0",
+    "puppeteer": "^3.0.0",
     "qrcode-terminal": "^0.12.0",
     "rosie": "^1.6.0",
     "runio.js": "^1.0.20",

package/typings/types.d.ts

@@ -2498,6 +2498,23 @@ declare namespace CodeceptJS {
          * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|Strict locator.
          */
         dontSeeElementInDOM(locator: CodeceptJS.LocatorOrString): void;
+        /**
+         * Handles a file download.Aa file name is required to save the file on disk.
+         * Files are saved to "output" directory.
+         *
+         * Should be used with [FileSystem helper](https://codecept.io/helpers/FileSystem) to check that file were downloaded correctly.
+         *
+         * ```js
+         * I.handleDownloads('downloads/avatar.jpg');
+         * I.click('Download Avatar');
+         * I.amInPath('output/downloads');
+         * I.waitForFile('downloads/avatar.jpg', 5);
+         *
+         * ```
+         *
+         * @param {string} [fileName] set filename for downloaded file
+         */
+        handleDownloads(fileName?: string): void;
         /**
          * Perform a click on a link or a button, given by a locator.
          * If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
@@ -5109,6 +5126,39 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * Perform an emulated click on a link or a button, given by a locator.
+         * Unlike normal click instead of sending native event, emulates a click with JavaScript.
+         * This works on hidden, animated or inactive elements as well.
+         *
+         * If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+         * For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+         * For images, the "alt" attribute and inner text of any parent links are searched.
+         *
+         * The second parameter is a context (CSS or XPath locator) to narrow the search.
+         *
+         * ```js
+         * // simple link
+         * I.forceClick('Logout');
+         * // button of form
+         * I.forceClick('Submit');
+         * // CSS button
+         * I.forceClick('#form input[type=submit]');
+         * // XPath
+         * I.forceClick('//form/*[@type=submit]');
+         * // link in context
+         * I.forceClick('Logout', '#nav');
+         * // using strict locator
+         * I.forceClick({css: 'nav a.login'});
+         * ```
+         *
+         * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+         * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         *
+         *
+         * {{ react }}
+         */
+        forceClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
          * Performs a click on a link and waits for navigation before moving on.
          *
@@ -7120,7 +7170,8 @@ declare namespace CodeceptJS {
          * Find a clickable element by providing human readable text:
          *
          * ```js
-         * this.helpers['WebDriver']._locateClickable('Next page').then // ...
+         * const els = await this.helpers.WebDriver._locateClickable('Next page');
+         * const els = await this.helpers.WebDriver._locateClickable('Next page', '.pages');
          * ```
          *
          * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
@@ -7193,6 +7244,39 @@ declare namespace CodeceptJS {
          * {{ react }}
          */
         click(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
+        /**
+         * Perform an emulated click on a link or a button, given by a locator.
+         * Unlike normal click instead of sending native event, emulates a click with JavaScript.
+         * This works on hidden, animated or inactive elements as well.
+         *
+         * If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+         * For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+         * For images, the "alt" attribute and inner text of any parent links are searched.
+         *
+         * The second parameter is a context (CSS or XPath locator) to narrow the search.
+         *
+         * ```js
+         * // simple link
+         * I.forceClick('Logout');
+         * // button of form
+         * I.forceClick('Submit');
+         * // CSS button
+         * I.forceClick('#form input[type=submit]');
+         * // XPath
+         * I.forceClick('//form/*[@type=submit]');
+         * // link in context
+         * I.forceClick('Logout', '#nav');
+         * // using strict locator
+         * I.forceClick({css: 'nav a.login'});
+         * ```
+         *
+         * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+         * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+         *
+         *
+         * {{ react }}
+         */
+        forceClick(locator: CodeceptJS.LocatorOrString, context?: CodeceptJS.LocatorOrString): void;
         /**
          * Performs a double-click on an element matched by link|button|label|CSS or XPath.
          * Context can be specified as second parameter to narrow search.
@@ -9970,6 +10054,7 @@ declare namespace CodeceptJS {
          * @property {'test.passed'} passed
          * @property {'test.failed'} failed
          * @property {'test.finish'} finished
+         * @property {'test.skipped'} skipped
          */
         const test: {
             started: 'test.start';
@@ -9978,6 +10063,7 @@ declare namespace CodeceptJS {
             passed: 'test.passed';
             failed: 'test.failed';
             finished: 'test.finish';
+            skipped: 'test.skipped';
         };
         /**
          * @type {object}