codeceptjs 3.6.6-beta.5 → 3.6.6-beta.6

package/docs/webapi/grabNumberOfVisibleElements.mustache

@@ -3,7 +3,9 @@ Resumes test execution, so **should be used inside async function with `await`**
 
 ```js
 let numOfElements = await I.grabNumberOfVisibleElements('p');
+let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
 ```
 
 @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
-@returns {Promise<number>} number of visible elements
+@param {number} [sec] (optional, `1` by default) time in seconds to wait
+@returns {Promise<number>} number of visible elements

package/lib/cli.js

@@ -145,7 +145,6 @@ class Cli extends Base {
 
   result() {
     const stats = this.stats;
-    stats.failedHooks = 0;
     console.log();
 
     // passes
@@ -217,14 +216,8 @@ class Cli extends Base {
       console.log();
     }
 
-    this.failures.forEach((failure) => {
-      if (failure.constructor.name === 'Hook') {
-        stats.failures -= stats.failures
-        stats.failedHooks += 1
-      }
-    })
     event.emit(event.all.failures, { failuresLog, stats });
-    output.result(stats.passes, stats.failures, stats.pending, ms(stats.duration), stats.failedHooks);
+    output.result(stats.passes, stats.failures, stats.pending, ms(stats.duration));
 
     if (stats.failures && output.level() < 3) {
       output.print(output.styles.debug('Run with --verbose flag to see complete NodeJS stacktrace'));

package/lib/command/workers/runTests.js

@@ -264,10 +264,7 @@ function collectStats() {
   event.dispatcher.on(event.test.passed, () => {
     stats.passes++;
   });
-  event.dispatcher.on(event.test.failed, (test) => {
-    if (test.ctx._runnable.title.includes('hook: AfterSuite')) {
-      stats.failedHooks += 1;
-    }
+  event.dispatcher.on(event.test.failed, () => {
     stats.failures++;
   });
   event.dispatcher.on(event.test.skipped, () => {

package/lib/helper/Playwright.js

@@ -24,6 +24,7 @@ const {
   clearString,
   requireWithFallback,
   normalizeSpacesInString,
+  promiseWithTimeout,
 } = require('../utils')
 const { isColorProperty, convertColorToRGBA } = require('../colorUtils')
 const ElementNotFound = require('./errors/ElementNotFound')
@@ -1851,10 +1852,19 @@ class Playwright extends Helper {
    * {{> grabNumberOfVisibleElements }}
    *
    */
-  async grabNumberOfVisibleElements(locator) {
+  async grabNumberOfVisibleElements(locator, sec) {
+    const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
     let els = await this._locate(locator)
-    els = await Promise.all(els.map((el) => el.isVisible()))
-    return els.filter((v) => v).length
+
+    const visibilityChecks = els.map((el) => promiseWithTimeout(el.isVisible(), waitTimeout))
+
+    try {
+      els = await Promise.all(visibilityChecks)
+      return els.filter((v) => v).length
+    } catch (error) {
+      console.error(error)
+      return 0
+    }
   }
 
   /**

package/lib/helper/Puppeteer.js

@@ -28,6 +28,7 @@ const {
   isModifierKey,
   requireWithFallback,
   normalizeSpacesInString,
+  promiseWithTimeout,
 } = require('../utils')
 const { isColorProperty, convertColorToRGBA } = require('../colorUtils')
 const ElementNotFound = require('./errors/ElementNotFound')
@@ -1514,17 +1515,20 @@ class Puppeteer extends Helper {
    * {{> grabNumberOfVisibleElements }}
    * {{ react }}
    */
-  async grabNumberOfVisibleElements(locator) {
+  async grabNumberOfVisibleElements(locator, sec) {
+    const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
     let els = await this._locate(locator)
-    els = (await Promise.all(els.map((el) => el.boundingBox() && el))).filter((v) => v)
+    els = (await Promise.all(els.map((el) => promiseWithTimeout(el.boundingBox() && el, waitTimeout)))).filter((v) => v)
     // Puppeteer visibility was ignored? | Remove when Puppeteer is fixed
     els = await Promise.all(
-      els.map(
-        async (el) =>
-          (await el.evaluate(
+      els.map((el) =>
+        promiseWithTimeout(
+          el.evaluate(
             (node) =>
               window.getComputedStyle(node).visibility !== 'hidden' && window.getComputedStyle(node).display !== 'none',
-          )) && el,
+          ) && el,
+          waitTimeout,
+        ),
       ),
     )
 

package/lib/helper/TestCafe.js

@@ -15,7 +15,7 @@ const stringIncludes = require('../assert/include').includes
 const { urlEquals } = require('../assert/equal')
 const { empty } = require('../assert/empty')
 const { truth } = require('../assert/truth')
-const { xpathLocator, normalizeSpacesInString } = require('../utils')
+const { xpathLocator, normalizeSpacesInString, promiseWithTimeout } = require('../utils')
 const Locator = require('../locator')
 
 /**
@@ -696,8 +696,12 @@ class TestCafe extends Helper {
   /**
    * {{> grabNumberOfVisibleElements }}
    */
-  async grabNumberOfVisibleElements(locator) {
-    const count = (await findElements.call(this, this.context, locator)).filterVisible().count
+  async grabNumberOfVisibleElements(locator, sec) {
+    const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout
+
+    const elements = await promiseWithTimeout(findElements.call(this, this.context, locator), waitTimeout)
+    const visibleElements = await elements.filterVisible()
+    const count = visibleElements.count
     return count
   }
 

package/lib/helper/WebDriver.js

@@ -19,6 +19,7 @@ const {
   screenshotOutputFolder,
   getNormalizedKeyAttributeValue,
   modifierKeys,
+  promiseWithTimeout,
 } = require('../utils')
 const { isColorProperty, convertColorToRGBA } = require('../colorUtils')
 const ElementNotFound = require('./errors/ElementNotFound')
@@ -1701,12 +1702,16 @@ class WebDriver extends Helper {
   /**
    * {{> grabNumberOfVisibleElements }}
    */
-  async grabNumberOfVisibleElements(locator) {
+  async grabNumberOfVisibleElements(locator, sec) {
+    const waitTimeout = sec || this.options.waitForTimeoutInSeconds
     const res = await this._locate(locator)
 
-    let selected = await forEachAsync(res, async (el) => el.isDisplayed())
+    let selected = await forEachAsync(res, async (el) => promiseWithTimeout(el.isDisplayed(), waitTimeout))
+
     if (!Array.isArray(selected)) selected = [selected]
+
     selected = selected.filter((val) => val === true)
+
     return selected.length
   }
 

package/lib/output.js

@@ -206,7 +206,7 @@ module.exports = {
    * @param {number} skipped
    * @param {number|string} duration
    */
-  result(passed, failed, skipped, duration, failedHooks = 0) {
+  result(passed, failed, skipped, duration) {
     let style = colors.bgGreen;
     let msg = ` ${passed || 0} passed`;
     let status = style.bold('  OK ');
@@ -215,12 +215,6 @@ module.exports = {
       status = style.bold('  FAIL ');
       msg += `, ${failed} failed`;
     }
-
-    if (failedHooks > 0) {
-      style = style.bgRed;
-      status = style.bold('  FAIL ');
-      msg += `, ${failedHooks} failedHooks`;
-    }
     status += style.grey(' |');
 
     if (skipped) {

package/lib/utils.js

@@ -476,3 +476,11 @@ module.exports.printObjectProperties = (obj) => {
 module.exports.normalizeSpacesInString = (string) => {
   return string.replace(/\s+/g, ' ');
 };
+
+module.exports.promiseWithTimeout = (promise, timeout = 1000) => {
+  return Promise.race([
+    promise,
+    new Promise((_, reject) => { setTimeout(() => reject(new Error(`Set timeout: ${timeout / 1000} sec(s). Timeout exceeded`)), timeout) },
+    ),
+  ]);
+};

package/lib/workers.js

@@ -357,7 +357,6 @@ class Workers extends EventEmitter {
 
   run() {
     this.stats.start = new Date();
-    this.stats.failedHooks = 0
     recorder.startUnlessRunning();
     event.dispatcher.emit(event.workers.before);
     process.env.RUNS_WITH_WORKERS = 'true';
@@ -472,7 +471,6 @@ class Workers extends EventEmitter {
     this.stats.failures += newStats.failures;
     this.stats.tests += newStats.tests;
     this.stats.pending += newStats.pending;
-    this.stats.failedHooks += newStats.failedHooks;
   }
 
   printResults() {
@@ -494,7 +492,7 @@ class Workers extends EventEmitter {
       this.failuresLog.forEach(log => output.print(...log));
     }
 
-    output.result(this.stats.passes, this.stats.failures, this.stats.pending, ms(this.stats.duration), this.stats.failedHooks);
+    output.result(this.stats.passes, this.stats.failures, this.stats.pending, ms(this.stats.duration));
     process.env.RUNS_WITH_WORKERS = 'false';
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.6.6-beta.5",
+  "version": "3.6.6-beta.6",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -78,7 +78,7 @@
     "@xmldom/xmldom": "0.8.10",
     "acorn": "8.12.1",
     "arrify": "2.0.1",
-    "axios": "1.7.3",
+    "axios": "1.7.7",
     "chai": "5.1.1",
     "chai-deep-match": "1.2.1",
     "chai-exclude": "2.1.1",

package/typings/promiseBasedTypes.d.ts

@@ -963,11 +963,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
          *
@@ -1181,14 +1183,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
@@ -1301,14 +1295,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): Promise<any>;
@@ -1981,14 +1967,6 @@ declare namespace CodeceptJS {
      * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -2114,14 +2092,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -2437,11 +2407,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * 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.
@@ -3196,14 +3168,6 @@ declare namespace CodeceptJS {
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -4352,11 +4316,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -6013,11 +5979,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that all elements with given locator have given CSS properties.
          *
@@ -6581,14 +6549,6 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -7530,12 +7490,15 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
+         *
          * {{ react }}
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -8396,14 +8359,6 @@ declare namespace CodeceptJS {
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9310,11 +9265,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that the given input field or textarea equals to given value.
          * For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
@@ -9767,14 +9724,6 @@ declare namespace CodeceptJS {
      * @property [devtoolsProtocol = false] - enable devtools protocol. Default: false. More info: https://webdriver.io/docs/automationProtocols/#devtools-protocol.
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -10863,11 +10812,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *

package/typings/types.d.ts

@@ -971,11 +971,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
          *
@@ -1205,14 +1207,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
@@ -1325,14 +1319,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class ExpectHelper {
         expectEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
         expectNotEqual(actualValue: any, expectedValue: any, customErrorMsg?: any): void;
@@ -2008,14 +1994,6 @@ declare namespace CodeceptJS {
      * @property [httpsOpts] - key & cert values are the paths to .key and .crt files
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -2141,14 +2119,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -2484,11 +2454,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * 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.
@@ -3289,14 +3261,6 @@ declare namespace CodeceptJS {
      * @property [testIdAttribute = data-testid] - locate elements based on the testIdAttribute. See more of [locate by test id](https://playwright.dev/docs/locators#locate-by-test-id).
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -4482,11 +4446,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -6221,11 +6187,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that all elements with given locator have given CSS properties.
          *
@@ -6825,14 +6793,6 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -7838,12 +7798,15 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
+         *
          * {{ react }}
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *
@@ -8776,14 +8739,6 @@ declare namespace CodeceptJS {
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9724,11 +9679,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that the given input field or textarea equals to given value.
          * For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
@@ -10207,14 +10164,6 @@ declare namespace CodeceptJS {
      * @property [devtoolsProtocol = false] - enable devtools protocol. Default: false. More info: https://webdriver.io/docs/automationProtocols/#devtools-protocol.
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -11370,11 +11319,13 @@ declare namespace CodeceptJS {
          *
          * ```js
          * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * let numOfElementsWithWait = await I.grabNumberOfVisibleElements('p', 2); // timeout applied
          * ```
          * @param locator - located by CSS|XPath|strict locator.
+         * @param [sec] - (optional, `1` by default) time in seconds to wait
          * @returns number of visible elements
          */
-        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString, sec?: number): Promise<number>;
         /**
          * Checks that current url contains a provided fragment.
          *