codeceptjs 3.7.6-beta.1 → 3.7.6-beta.3

package/lib/plugin/htmlReporter.js

@@ -103,12 +103,12 @@ module.exports = function (config) {
       // Method 1: Check retryNum property (most reliable)
       if (test.retryNum && test.retryNum > 0) {
         testRetryAttempts.set(testId, test.retryNum)
-        output.print(`HTML Reporter: Retry count detected (retryNum) for ${test.title}, attempts: ${test.retryNum}`)
+        output.debug(`HTML Reporter: Retry count detected (retryNum) for ${test.title}, attempts: ${test.retryNum}`)
       }
       // Method 2: Check currentRetry property
       else if (test.currentRetry && test.currentRetry > 0) {
         testRetryAttempts.set(testId, test.currentRetry)
-        output.print(`HTML Reporter: Retry count detected (currentRetry) for ${test.title}, attempts: ${test.currentRetry}`)
+        output.debug(`HTML Reporter: Retry count detected (currentRetry) for ${test.title}, attempts: ${test.currentRetry}`)
       }
       // Method 3: Check if this is a retried test
       else if (test.retriedTest && test.retriedTest()) {
@@ -119,12 +119,12 @@ module.exports = function (config) {
         } else {
           testRetryAttempts.set(originalTestId, testRetryAttempts.get(originalTestId) + 1)
         }
-        output.print(`HTML Reporter: Retry detected (retriedTest) for ${originalTest.title}, attempts: ${testRetryAttempts.get(originalTestId)}`)
+        output.debug(`HTML Reporter: Retry detected (retriedTest) for ${originalTest.title}, attempts: ${testRetryAttempts.get(originalTestId)}`)
       }
       // Method 4: Check if test has been seen before (indicating a retry)
       else if (reportData.tests.some(t => t.id === testId)) {
         testRetryAttempts.set(testId, 1) // First retry detected
-        output.print(`HTML Reporter: Retry detected (duplicate test) for ${test.title}, attempts: 1`)
+        output.debug(`HTML Reporter: Retry detected (duplicate test) for ${test.title}, attempts: 1`)
       }
     }
   })
@@ -196,20 +196,20 @@ module.exports = function (config) {
       if (test.retryNum && test.retryNum > 0) {
         retryAttempts = test.retryNum
         testRetryAttempts.set(testId, retryAttempts)
-        output.print(`HTML Reporter: Late retry detection (retryNum) for ${test.title}, attempts: ${retryAttempts}`)
+        output.debug(`HTML Reporter: Late retry detection (retryNum) for ${test.title}, attempts: ${retryAttempts}`)
       } else if (test.currentRetry && test.currentRetry > 0) {
         retryAttempts = test.currentRetry
         testRetryAttempts.set(testId, retryAttempts)
-        output.print(`HTML Reporter: Late retry detection (currentRetry) for ${test.title}, attempts: ${retryAttempts}`)
+        output.debug(`HTML Reporter: Late retry detection (currentRetry) for ${test.title}, attempts: ${retryAttempts}`)
       } else if (test._retries && test._retries > 0) {
         retryAttempts = test._retries
         testRetryAttempts.set(testId, retryAttempts)
-        output.print(`HTML Reporter: Late retry detection (_retries) for ${test.title}, attempts: ${retryAttempts}`)
+        output.debug(`HTML Reporter: Late retry detection (_retries) for ${test.title}, attempts: ${retryAttempts}`)
       }
     }
 
     // Debug logging
-    output.print(`HTML Reporter: Test finished - ${test.title}, State: ${test.state}, Retries: ${retryAttempts}`)
+    output.debug(`HTML Reporter: Test finished - ${test.title}, State: ${test.state}, Retries: ${retryAttempts}`)
 
     // Detect if this is a BDD/Gherkin test
     const isBddTest = isBddGherkinTest(test, currentSuite)
@@ -222,7 +222,7 @@ module.exports = function (config) {
     const currentlyFailed = test.state === 'failed'
 
     // Debug artifacts collection (but don't process them yet - screenshots may not be ready)
-    output.print(`HTML Reporter: Test ${test.title} artifacts at test.finished: ${JSON.stringify(test.artifacts)}`)
+    output.debug(`HTML Reporter: Test ${test.title} artifacts at test.finished: ${JSON.stringify(test.artifacts)}`)
 
     const testData = {
       ...test,
@@ -244,11 +244,11 @@ module.exports = function (config) {
     if (existingTestIndex >= 0) {
       // Update existing test with final result (including failed state)
       reportData.tests[existingTestIndex] = testData
-      output.print(`HTML Reporter: Updated existing test - ${test.title}, Final state: ${test.state}`)
+      output.debug(`HTML Reporter: Updated existing test - ${test.title}, Final state: ${test.state}`)
     } else {
       // Add new test
       reportData.tests.push(testData)
-      output.print(`HTML Reporter: Added new test - ${test.title}, State: ${test.state}`)
+      output.debug(`HTML Reporter: Added new test - ${test.title}, State: ${test.state}`)
     }
 
     // Track retry information - only add if there were actual retries AND the test failed at some point
@@ -262,7 +262,7 @@ module.exports = function (config) {
       if (retryAttempts === 0 && existingRetryIndex >= 0) {
         retryAttempts = reportData.retries[existingRetryIndex].attempts + 1
         testRetryAttempts.set(testId, retryAttempts)
-        output.print(`HTML Reporter: Incremented retry count for duplicate test ${test.title}, attempts: ${retryAttempts}`)
+        output.debug(`HTML Reporter: Incremented retry count for duplicate test ${test.title}, attempts: ${retryAttempts}`)
       }
 
       // Remove existing retry info for this test and add updated one
@@ -274,7 +274,7 @@ module.exports = function (config) {
         finalState: test.state,
         duration: test.duration || 0,
       })
-      output.print(`HTML Reporter: Added retry info for ${test.title}, attempts: ${retryAttempts}, state: ${test.state}`)
+      output.debug(`HTML Reporter: Added retry info for ${test.title}, attempts: ${retryAttempts}, state: ${test.state}`)
     }
 
     // Fallback: If this test already exists and either failed before or is failing now, it's a retry
@@ -288,7 +288,7 @@ module.exports = function (config) {
         finalState: test.state,
         duration: test.duration || 0,
       })
-      output.print(`HTML Reporter: Fallback retry detection for failed test ${test.title}, attempts: ${fallbackAttempts}`)
+    output.debug(`HTML Reporter: Fallback retry detection for failed test ${test.title}, attempts: ${fallbackAttempts}`)
     }
   })
 
@@ -298,40 +298,40 @@ module.exports = function (config) {
     reportData.duration = reportData.endTime - reportData.startTime
 
     // Process artifacts now that all async tasks (including screenshots) are complete
-    output.print(`HTML Reporter: Processing artifacts for ${reportData.tests.length} tests after all async tasks complete`)
+    output.debug(`HTML Reporter: Processing artifacts for ${reportData.tests.length} tests after all async tasks complete`)
 
     reportData.tests.forEach(test => {
       const originalArtifacts = test.artifacts
       let collectedArtifacts = []
 
-      output.print(`HTML Reporter: Processing test "${test.title}" (ID: ${test.id})`)
-      output.print(`HTML Reporter: Test ${test.title} final artifacts: ${JSON.stringify(originalArtifacts)}`)
+      output.debug(`HTML Reporter: Processing test "${test.title}" (ID: ${test.id})`)
+      output.debug(`HTML Reporter: Test ${test.title} final artifacts: ${JSON.stringify(originalArtifacts)}`)
 
       if (originalArtifacts) {
         if (Array.isArray(originalArtifacts)) {
           collectedArtifacts = originalArtifacts
-          output.print(`HTML Reporter: Using array artifacts: ${collectedArtifacts.length} items`)
+          output.debug(`HTML Reporter: Using array artifacts: ${collectedArtifacts.length} items`)
         } else if (typeof originalArtifacts === 'object') {
           // Convert object properties to array (screenshotOnFail plugin format)
           collectedArtifacts = Object.values(originalArtifacts).filter(artifact => artifact)
-          output.print(`HTML Reporter: Converted artifacts object to array: ${collectedArtifacts.length} items`)
-          output.print(`HTML Reporter: Converted artifacts: ${JSON.stringify(collectedArtifacts)}`)
+          output.debug(`HTML Reporter: Converted artifacts object to array: ${collectedArtifacts.length} items`)
+          output.debug(`HTML Reporter: Converted artifacts: ${JSON.stringify(collectedArtifacts)}`)
         }
       }
 
       // Only use filesystem fallback if no artifacts found from screenshotOnFail plugin
       if (collectedArtifacts.length === 0 && test.state === 'failed') {
-        output.print(`HTML Reporter: No artifacts from plugin, trying filesystem for test "${test.title}"`)
+        output.debug(`HTML Reporter: No artifacts from plugin, trying filesystem for test "${test.title}"`)
         collectedArtifacts = collectScreenshotsFromFilesystem(test, test.id)
-        output.print(`HTML Reporter: Collected ${collectedArtifacts.length} screenshots from filesystem for failed test "${test.title}"`)
+        output.debug(`HTML Reporter: Collected ${collectedArtifacts.length} screenshots from filesystem for failed test "${test.title}"`)
         if (collectedArtifacts.length > 0) {
-          output.print(`HTML Reporter: Filesystem screenshots for "${test.title}": ${JSON.stringify(collectedArtifacts)}`)
+          output.debug(`HTML Reporter: Filesystem screenshots for "${test.title}": ${JSON.stringify(collectedArtifacts)}`)
         }
       }
 
       // Update test with processed artifacts
       test.artifacts = collectedArtifacts
-      output.print(`HTML Reporter: Final artifacts for "${test.title}": ${JSON.stringify(test.artifacts)}`)
+      output.debug(`HTML Reporter: Final artifacts for "${test.title}": ${JSON.stringify(test.artifacts)}`)
     })
 
     // Calculate stats from our collected test data instead of using result.stats
@@ -384,19 +384,19 @@ module.exports = function (config) {
     }
 
     // Debug logging for final stats
-    output.print(`HTML Reporter: Calculated stats - Tests: ${reportData.stats.tests}, Passes: ${reportData.stats.passes}, Failures: ${reportData.stats.failures}`)
-    output.print(`HTML Reporter: Collected ${reportData.tests.length} tests in reportData`)
-    output.print(`HTML Reporter: Failures array has ${reportData.failures.length} items`)
-    output.print(`HTML Reporter: Retries array has ${reportData.retries.length} items`)
-    output.print(`HTML Reporter: testRetryAttempts Map size: ${testRetryAttempts.size}`)
+    output.debug(`HTML Reporter: Calculated stats - Tests: ${reportData.stats.tests}, Passes: ${reportData.stats.passes}, Failures: ${reportData.stats.failures}`)
+    output.debug(`HTML Reporter: Collected ${reportData.tests.length} tests in reportData`)
+    output.debug(`HTML Reporter: Failures array has ${reportData.failures.length} items`)
+    output.debug(`HTML Reporter: Retries array has ${reportData.retries.length} items`)
+    output.debug(`HTML Reporter: testRetryAttempts Map size: ${testRetryAttempts.size}`)
 
     // Log retry attempts map contents
     for (const [testId, attempts] of testRetryAttempts.entries()) {
-      output.print(`HTML Reporter: testRetryAttempts - ${testId}: ${attempts} attempts`)
+      output.debug(`HTML Reporter: testRetryAttempts - ${testId}: ${attempts} attempts`)
     }
 
     reportData.tests.forEach(test => {
-      output.print(`HTML Reporter: Test in reportData - ${test.title}, State: ${test.state}, Retries: ${test.retryAttempts}`)
+      output.debug(`HTML Reporter: Test in reportData - ${test.title}, State: ${test.state}, Retries: ${test.retryAttempts}`)
     })
 
     // Check if running with workers

package/lib/result.js

@@ -3,22 +3,21 @@ const path = require('path')
 const { serializeTest } = require('./mocha/test')
 
 /**
- * Result of the test run
- *
- * @typedef {Object} Stats
- * @property {number} passes
- * @property {number} failures
- * @property {number} tests
- * @property {number} pending
- * @property {number} failedHooks
- * @property {Date} start
- * @property {Date} end
- * @property {number} duration
+ * @typedef {Object} Stats Statistics for a test result.
+ * @property {number} passes Number of passed tests.
+ * @property {number} failures Number of failed tests.
+ * @property {number} tests Total number of tests.
+ * @property {number} pending Number of pending tests.
+ * @property {number} failedHooks Number of failed hooks.
+ * @property {Date} start Start time of the test run.
+ * @property {Date} end End time of the test run.
+ * @property {number} duration Duration of the test run, in milliseconds.
+ */
+
+/**
+ * Result of a test run. Will be emitted for example in "event.all.result" events.
  */
 class Result {
-  /**
-   * Create Result of the test run
-   */
   constructor() {
     this._startTime = new Date()
     this._endTime = null
@@ -27,6 +26,9 @@ class Result {
     this.start()
   }
 
+  /**
+   * Resets all collected stats, tests, and failure reports.
+   */
   reset() {
     this._stats = {
       passes: 0,
@@ -39,43 +41,85 @@ class Result {
       duration: 0,
     }
 
-    /** @type {CodeceptJS.Test[]} */
+    /**
+     * @type {CodeceptJS.Test[]}
+     * @private
+     */
     this._tests = []
 
-    /** @type {String[]} */
+    /**
+     * @type {string[][]}
+     * @private
+     */
     this._failures = []
   }
 
+  /**
+   * Sets the start time to the current time.
+   */
   start() {
     this._startTime = new Date()
   }
 
+  /**
+   * Sets the end time to the current time.
+   */
   finish() {
     this._endTime = new Date()
   }
 
+  /**
+   * Whether this result contains any failed tests.
+   *
+   * @type {boolean}
+   * @readonly
+   */
   get hasFailed() {
     return this._stats.failures > 0
   }
 
+  /**
+   * All collected tests.
+   *
+   * @type {CodeceptJS.Test[]}
+   * @readonly
+   */
   get tests() {
     return this._tests
   }
 
+  /**
+   * The failure reports (array of strings per failed test).
+   *
+   * @type {string[][]}
+   * @readonly
+   */
   get failures() {
     return this._failures.filter(f => f && (!Array.isArray(f) || f.length > 0))
   }
 
+  /**
+   * The test statistics.
+   *
+   * @type {Stats}
+   * @readonly
+   */
   get stats() {
     return this._stats
   }
 
+  /**
+   * The start time of the test run.
+   *
+   * @type {Date}
+   * @readonly
+   */
   get startTime() {
     return this._startTime
   }
 
   /**
-   * Add test to result
+   * Adds a test to this result.
    *
    * @param {CodeceptJS.Test} test
    */
@@ -90,34 +134,67 @@ class Result {
   }
 
   /**
-   * Add failures to result
+   * Adds failure reports to this result.
    *
-   * @param {String[]} newFailures
+   * @param {string[][]} newFailures
    */
   addFailures(newFailures) {
     this._failures.push(...newFailures)
   }
 
+  /**
+   * Whether this result contains any failed tests.
+   *
+   * @type {boolean}
+   * @readonly
+   */
   get hasFailures() {
     return this.stats.failures > 0
   }
 
+  /**
+   * The duration of the test run, in milliseconds.
+   *
+   * @type {number}
+   * @readonly
+   */
   get duration() {
     return this._endTime ? +this._endTime - +this._startTime : 0
   }
 
+  /**
+   * All failed tests.
+   *
+   * @type {CodeceptJS.Test[]}
+   * readonly
+   */
   get failedTests() {
     return this._tests.filter(test => test.state === 'failed')
   }
 
+  /**
+   * All passed tests.
+   *
+   * @type {CodeceptJS.Test[]}
+   * @readonly
+   */
   get passedTests() {
     return this._tests.filter(test => test.state === 'passed')
   }
 
+  /**
+   * All skipped tests.
+   *
+   * @type {CodeceptJS.Test[]}
+   * @readonly
+   */
   get skippedTests() {
     return this._tests.filter(test => test.state === 'skipped' || test.state === 'pending')
   }
 
+  /**
+   * @returns {object} The JSON representation of this result.
+   */
   simplify() {
     return {
       hasFailed: this.hasFailed,
@@ -129,9 +206,9 @@ class Result {
   }
 
   /**
-   * Save result to json file
+   * Saves this result to a JSON file.
    *
-   * @param {string} fileName
+   * @param {string} [fileName] Path to the JSON file, relative to `output_dir`. Defaults to "result.json".
    */
   save(fileName) {
     if (!fileName) fileName = 'result.json'
@@ -139,9 +216,9 @@ class Result {
   }
 
   /**
-   * Add stats to result
+   * Adds stats to this result.
    *
-   * @param {object} newStats
+   * @param {Partial<Stats>} [newStats]
    */
   addStats(newStats = {}) {
     this._stats.passes += newStats.passes || 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.7.6-beta.1",
+  "version": "3.7.6-beta.3",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -96,7 +96,7 @@
     "cross-spawn": "7.0.6",
     "css-to-xpath": "0.1.0",
     "csstoxpath": "1.6.0",
-    "envinfo": "7.14.0",
+    "envinfo": "7.15.0",
     "escape-string-regexp": "4.0.0",
     "figures": "3.2.0",
     "fn-args": "4.0.0",
@@ -138,7 +138,7 @@
     "@pollyjs/core": "6.0.6",
     "@types/chai": "5.2.2",
     "@types/inquirer": "9.0.9",
-    "@types/node": "24.5.2",
+    "@types/node": "^24.6.0",
     "@wdio/sauce-service": "9.12.5",
     "@wdio/selenium-standalone-service": "8.15.0",
     "@wdio/utils": "9.19.2",
@@ -147,11 +147,11 @@
     "chai-as-promised": "7.1.2",
     "chai-subset": "1.6.0",
     "documentation": "14.0.3",
-    "electron": "38.1.2",
+    "electron": "38.2.0",
     "eslint": "^9.36.0",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-mocha": "11.1.0",
-    "expect": "30.1.2",
+    "expect": "30.2.0",
     "express": "^5.1.0",
     "globals": "16.4.0",
     "graphql": "16.11.0",

package/typings/index.d.ts

@@ -97,7 +97,7 @@ declare namespace CodeceptJS {
      * tests: 'tests/**.test.ts'
      * ```
      */
-    tests: string
+    tests: string | string[]
     /**
      * Where to store failure screenshots, artifacts, etc
      *
@@ -520,17 +520,16 @@ declare namespace CodeceptJS {
   }
 }
 
-type TryTo = <T>(fn: () => Promise<T> | T) => Promise<T | false>;
-type HopeThat = <T>(fn: () => Promise<T> | T) => Promise<T | false>;
-type RetryTo = <T>(fn: () => Promise<T> | T, retries?: number) => Promise<T>;
-
+type TryTo = <T>(fn: () => Promise<T> | T) => Promise<T | false>
+type HopeThat = <T>(fn: () => Promise<T> | T) => Promise<T | false>
+type RetryTo = <T>(fn: () => Promise<T> | T, retries?: number) => Promise<T>
 
 // Globals
 declare const codecept_dir: string
 declare const output_dir: string
-declare const tryTo: TryTo;
-declare const retryTo: RetryTo;
-declare const hopeThat: HopeThat;
+declare const tryTo: TryTo
+declare const retryTo: RetryTo
+declare const hopeThat: HopeThat
 
 declare const actor: CodeceptJS.actor
 declare const codecept_actor: CodeceptJS.actor
@@ -643,7 +642,7 @@ declare module '@codeceptjs/helper' {
 }
 
 declare module 'codeceptjs/effects' {
-  export const tryTo: TryTo;
-  export const retryTo: RetryTo;
-  export const hopeThat: HopeThat;
+  export const tryTo: TryTo
+  export const retryTo: RetryTo
+  export const hopeThat: HopeThat
 }

package/typings/promiseBasedTypes.d.ts

@@ -2733,10 +2733,14 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [recordHar] - record HAR and will be saved to `output/har`. See more of [HAR options](https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har).
      * @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).
-     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(\`[role="\${selector}\"]\`) } }`
+     * @property [customLocatorStrategies] - custom locator strategies. An object with keys as strategy names and values as JavaScript functions. Example: `{ byRole: (selector, root) => { return root.querySelector(`[role="${selector}"]`) } }`
+     * @property [storageState] - Playwright storage state (path to JSON file or object)
+     *   passed directly to `browser.newContext`.
+     *   If a Scenario is declared with a `cookies` option (e.g. `Scenario('name', { cookies: [...] }, fn)`),
+     *   those cookies are used instead and the configured `storageState` is ignored (no merge).
+     *   May include session cookies, auth tokens, localStorage and (if captured with
+     *   `grabStorageState({ indexedDB: true })`) IndexedDB data; treat as sensitive and do not commit.
      */
-    // @ts-ignore
-    // @ts-ignore
     type PlaywrightConfig = {
         url?: string;
         browser?: 'chromium' | 'firefox' | 'webkit' | 'electron';
@@ -2775,6 +2779,7 @@ declare namespace CodeceptJS {
         recordHar?: any;
         testIdAttribute?: string;
         customLocatorStrategies?: any;
+        storageState?: string | any;
     };
     /**
      * Uses [Playwright](https://github.com/microsoft/playwright) library to run tests inside:
@@ -3686,7 +3691,7 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): Promise<any>;
         /**
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313](https://github.com/puppeteer/puppeteer/issues/1313)).
          *
          * Presses a key in the browser (on a focused element).
          *
@@ -4085,6 +4090,27 @@ declare namespace CodeceptJS {
          * @param [name = null] - cookie name.
          */
         grabCookie(name?: string): Promise<any>;
+        /**
+         * Grab the current storage state (cookies, localStorage, etc.) via Playwright's `browserContext.storageState()`.
+         * Returns the raw object that Playwright provides.
+         *
+         * Security: The returned object can contain authentication tokens, session cookies
+         * and (when `indexedDB: true` is used) data that may include user PII. Treat it as a secret.
+         * Avoid committing it to source control and prefer storing it in a protected secrets store / CI artifact vault.
+         * @param [options.indexedDB] - set to true to include IndexedDB in snapshot (Playwright >=1.51)
+         *
+         * ```js
+         * // basic usage
+         * const state = await I.grabStorageState();
+         * require('fs').writeFileSync('authState.json', JSON.stringify(state));
+         *
+         * // include IndexedDB when using Firebase Auth, etc.
+         * const stateWithIDB = await I.grabStorageState({ indexedDB: true });
+         * ```
+         */
+        grabStorageState(options?: {
+            indexedDB?: boolean;
+        }): Promise<any>;
         /**
          * Clears a cookie by name,
          * if none provided clears all cookies.
@@ -4515,7 +4541,7 @@ declare namespace CodeceptJS {
         /**
          * Waits for navigation to finish. By default, it takes configured `waitForNavigation` option.
          *
-         * See [Playwright's reference](https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions)
+         * See [Playwright's reference](https://playwright.dev/docs/api/class-page#page-wait-for-navigation)
          */
         waitForNavigation(options: any): Promise<any>;
         /**
@@ -6103,7 +6129,7 @@ declare namespace CodeceptJS {
      * @property [keepBrowserState = false] - keep browser state between tests when `restart` is set to false.
      * @property [keepCookies = false] - keep cookies between tests when `restart` is set to false.
      * @property [waitForAction = 100] - how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
-     * @property [waitForNavigation = load] - when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions). Array values are accepted as well.
+     * @property [waitForNavigation = load] - when to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle0`, `networkidle2`. See [Puppeteer API](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.waitforoptions.md). Array values are accepted as well.
      * @property [pressKeyDelay = 10] - delay between key presses in ms. Used when calling Puppeteers page.type(...) in fillField/appendField
      * @property [getPageTimeout = 30000] - config option to set maximum navigation time in milliseconds. If the timeout is set to 0, then timeout will be disabled.
      * @property [waitForTimeout = 1000] - default wait* timeout in ms.
@@ -6111,11 +6137,9 @@ declare namespace CodeceptJS {
      * @property [userAgent] - user-agent string.
      * @property [manualStart = false] - do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
      * @property [browser = chrome] - can be changed to `firefox` when using [puppeteer-firefox](https://codecept.io/helpers/Puppeteer-firefox).
-     * @property [chrome] - pass additional [Puppeteer run options](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions).
+     * @property [chrome] - pass additional [Puppeteer run options](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.launchoptions.md).
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      */
-    // @ts-ignore
-    // @ts-ignore
     type PuppeteerConfig = {
         url: string;
         basicAuth?: any;
@@ -6129,7 +6153,7 @@ declare namespace CodeceptJS {
         keepBrowserState?: boolean;
         keepCookies?: boolean;
         waitForAction?: number;
-        waitForNavigation?: string;
+        waitForNavigation?: string | string[];
         pressKeyDelay?: number;
         getPageTimeout?: number;
         waitForTimeout?: number;
@@ -6141,7 +6165,7 @@ declare namespace CodeceptJS {
         highlightElement?: boolean;
     };
     /**
-     * Uses [Google Chrome's Puppeteer](https://github.com/GoogleChrome/puppeteer) library to run tests inside headless Chrome.
+     * Uses [Google Chrome's Puppeteer](https://github.com/puppeteer/puppeteer) library to run tests inside headless Chrome.
      * Browser control is executed via DevTools Protocol (instead of Selenium).
      * This helper works with a browser out of the box with no additional tools required to install.
      *
@@ -6883,7 +6907,7 @@ declare namespace CodeceptJS {
          */
         pressKeyUp(key: string): Promise<any>;
         /**
-         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313](https://github.com/GoogleChrome/puppeteer/issues/1313)).
+         * _Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([puppeteer/puppeteer#1313](https://github.com/puppeteer/puppeteer/issues/1313)).
          *
          * Presses a key in the browser (on a focused element).
          *
@@ -7731,7 +7755,7 @@ declare namespace CodeceptJS {
         /**
          * Waits for navigation to finish. By default, takes configured `waitForNavigation` option.
          *
-         * See [Puppeteer's reference](https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#pagewaitfornavigationoptions)
+         * See [Puppeteer's reference](https://github.com/puppeteer/puppeteer/blob/main/docs/api/puppeteer.page.waitfornavigation.md)
          */
         waitForNavigation(opts: any): Promise<any>;
         /**
@@ -7960,8 +7984,6 @@ declare namespace CodeceptJS {
      * @property [onResponse] - an async function which can update response object.
      * @property [maxUploadFileSize] - set the max content file size in MB when performing api calls.
      */
-    // @ts-ignore
-    // @ts-ignore
     type RESTConfig = {
         endpoint?: string;
         prettyPrintJson?: boolean;
@@ -9117,8 +9139,6 @@ declare namespace CodeceptJS {
      * @property [highlightElement] - highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
      * @property [logLevel = silent] - level of logging verbosity. Default: silent. Options: trace | debug | info | warn | error | silent. More info: https://webdriver.io/docs/configuration/#loglevel
      */
-    // @ts-ignore
-    // @ts-ignore
     type WebDriverConfig = {
         url: string;
         browser: string;