codeceptjs 3.6.6-beta.4 → 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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.6.6-beta.4",
+  "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",
@@ -156,7 +156,7 @@
     "qrcode-terminal": "0.12.0",
     "rosie": "2.1.1",
     "runok": "0.9.3",
-    "semver": "^7.6.3",
+    "semver": "7.6.3",
     "sinon": "18.0.0",
     "sinon-chai": "3.7.0",
     "testcafe": "3.5.0",

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,12 +1183,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @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>;
@@ -1299,12 +1295,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @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>;
@@ -1977,12 +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
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -2108,12 +2092,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -2429,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.
@@ -3188,12 +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
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -4342,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.
          *
@@ -6003,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.
          *
@@ -6571,12 +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
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -7518,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.
          *
@@ -8384,12 +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
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9296,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.
@@ -9753,12 +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
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -10847,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,12 +1207,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @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;
@@ -1323,12 +1319,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @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;
@@ -2004,12 +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
     type MockServerConfig = {
         port?: number;
         host?: string;
@@ -2135,12 +2119,6 @@ declare namespace CodeceptJS {
      * ## Methods
      */
     // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
-    // @ts-ignore
     class MockServer {
         /**
          * Start the mock server
@@ -2476,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.
@@ -3281,12 +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
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -4472,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.
          *
@@ -6211,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.
          *
@@ -6815,12 +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
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -7826,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.
          *
@@ -8764,12 +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
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9710,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.
@@ -10193,12 +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
     type WebDriverConfig = {
         url: string;
         browser: string;
@@ -11354,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.
          *