codeceptjs 3.5.7-beta.1 → 3.5.8

package/docs/helpers/Playwright.md

@@ -27,6 +27,10 @@ or
 
     npm i playwright-core@^1.18 --save
 
+Breaking Changes: if you use Playwright v1.38 and later, it will no longer download browsers automatically.
+
+Run `npx playwright install` to download browsers after `npm install`.
+
 Using playwright-core package, will prevent the download of browser binaries and allow connecting to an existing browser installation or for connecting to a remote one.
 
 
@@ -41,23 +45,23 @@ Type: [object][5]
 
 -   `url` **[string][8]?** base url of website to be tested
 -   `browser` **(`"chromium"` | `"firefox"` | `"webkit"` | `"electron"`)?** a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
--   `show` **[boolean][32]?** show browser window.
--   `restart` **([string][8] | [boolean][32])?** restart strategy between tests. Possible values:-   'context' or **false** - restarts [browser context][40] but keeps running browser. Recommended by Playwright team to keep tests isolated.
+-   `show` **[boolean][25]?** show browser window.
+-   `restart` **([string][8] | [boolean][25])?** restart strategy between tests. Possible values:-   'context' or **false** - restarts [browser context][42] but keeps running browser. Recommended by Playwright team to keep tests isolated.
     -   'browser' or **true** - closes browser and opens it again between tests.
     -   'session' or 'keep' - keeps browser context and session, but cleans up cookies and localStorage between tests. The fastest option when running tests in windowed mode. Works with `keepCookies` and `keepBrowserState` options. This behavior was default before CodeceptJS 3.1
--   `timeout` **[number][20]?** -   [timeout][41] in ms of all Playwright actions .
--   `disableScreenshots` **[boolean][32]?** don't save screenshot on failure.
+-   `timeout` **[number][20]?** -   [timeout][43] in ms of all Playwright actions .
+-   `disableScreenshots` **[boolean][25]?** don't save screenshot on failure.
 -   `emulate` **any?** browser in device emulation mode.
--   `video` **[boolean][32]?** enables video recording for failed tests; videos are saved into `output/videos` folder
--   `keepVideoForPassedTests` **[boolean][32]?** save videos for passed tests; videos are saved into `output/videos` folder
--   `trace` **[boolean][32]?** record [tracing information][42] with screenshots and snapshots.
--   `keepTraceForPassedTests` **[boolean][32]?** save trace for passed tests.
--   `fullPageScreenshots` **[boolean][32]?** make full page screenshots on failure.
--   `uniqueScreenshotNames` **[boolean][32]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
--   `keepBrowserState` **[boolean][32]?** keep browser state between tests when `restart` is set to 'session'.
--   `keepCookies` **[boolean][32]?** keep cookies between tests when `restart` is set to 'session'.
+-   `video` **[boolean][25]?** enables video recording for failed tests; videos are saved into `output/videos` folder
+-   `keepVideoForPassedTests` **[boolean][25]?** save videos for passed tests; videos are saved into `output/videos` folder
+-   `trace` **[boolean][25]?** record [tracing information][44] with screenshots and snapshots.
+-   `keepTraceForPassedTests` **[boolean][25]?** save trace for passed tests.
+-   `fullPageScreenshots` **[boolean][25]?** make full page screenshots on failure.
+-   `uniqueScreenshotNames` **[boolean][25]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+-   `keepBrowserState` **[boolean][25]?** keep browser state between tests when `restart` is set to 'session'.
+-   `keepCookies` **[boolean][25]?** keep cookies between tests when `restart` is set to 'session'.
 -   `waitForAction` **[number][20]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
--   `waitForNavigation` **(`"load"` | `"domcontentloaded"` | `"commit"`)?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `commit`. Choose one of those options is possible. See [Playwright API][38].
+-   `waitForNavigation` **(`"load"` | `"domcontentloaded"` | `"commit"`)?** When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `commit`. Choose one of those options is possible. See [Playwright API][40].
 -   `pressKeyDelay` **[number][20]?** Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
 -   `getPageTimeout` **[number][20]?** config option to set maximum navigation time in milliseconds.
 -   `waitForTimeout` **[number][20]?** default wait* timeout in ms. Default: 1000.
@@ -66,15 +70,15 @@ Type: [object][5]
 -   `colorScheme` **(`"dark"` | `"light"` | `"no-preference"`)?** default color scheme. Possible values: `dark` | `light` | `no-preference`.
 -   `userAgent` **[string][8]?** user-agent string.
 -   `locale` **[string][8]?** locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
--   `manualStart` **[boolean][32]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
+-   `manualStart` **[boolean][25]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
 -   `chromium` **[object][5]?** pass additional chromium options
 -   `firefox` **[object][5]?** pass additional firefox options
 -   `electron` **[object][5]?** (pass additional electron options
--   `channel` **any?** (While Playwright can operate against the stock Google Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels of these browsers. See [Google Chrome & Microsoft Edge][43].
--   `ignoreLog` **[Array][10]<[string][8]>?** An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values][44].
--   `ignoreHTTPSErrors` **[boolean][32]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
--   `bypassCSP` **[boolean][32]?** bypass Content Security Policy or CSP
--   `highlightElement` **[boolean][32]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
+-   `channel` **any?** (While Playwright can operate against the stock Google Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels of these browsers. See [Google Chrome & Microsoft Edge][45].
+-   `ignoreLog` **[Array][10]<[string][8]>?** An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values][46].
+-   `ignoreHTTPSErrors` **[boolean][25]?** Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
+-   `bypassCSP` **[boolean][25]?** bypass Content Security Policy or CSP
+-   `highlightElement` **[boolean][25]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
 
 
 
@@ -991,6 +995,17 @@ console.log(JSON.stringify(errors));
 
 Returns **[Promise][9]<[Array][10]<any>>** 
 
+### grabCheckedElementStatus
+
+Return the checked status of given element.
+
+#### Parameters
+
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `options` **[object][5]?** See [https://playwright.dev/docs/api/class-locator#locator-is-checked][24] 
+
+Returns **[Promise][9]<[boolean][25]>** 
+
 ### grabCookie
 
 Gets a cookie object by name.
@@ -1078,6 +1093,17 @@ let data = await I.grabDataFromPerformanceTiming();
 
 Returns **[Promise][9]<void>** automatically synchronized promise through #recorder
 
+### grabDisabledElementStatus
+
+Return the disabled status of given element.
+
+#### Parameters
+
+-   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
+-   `options` **[object][5]?** See [https://playwright.dev/docs/api/class-locator#locator-is-disabled][26] 
+
+Returns **[Promise][9]<[boolean][25]>** 
+
 ### grabElementBoundingRect
 
 Grab the width, height, location of given locator.
@@ -1362,7 +1388,7 @@ Returns **[Array][10]<any>**
 Handles a file download. A file name is required to save the file on disk.
 Files are saved to "output" directory.
 
-Should be used with [FileSystem helper][24] to check that file were downloaded correctly.
+Should be used with [FileSystem helper][27] to check that file were downloaded correctly.
 
 ```js
 I.handleDownloads('downloads/avatar.jpg');
@@ -1379,7 +1405,7 @@ Returns **[Promise][9]<void>**
 
 ### makeApiRequest
 
-Performs [api request][25] using
+Performs [api request][28] using
 the cookies from the current browser session.
 
 ```js
@@ -1400,13 +1426,13 @@ Returns **[Promise][9]<[object][5]>** response
 
 ### mockRoute
 
-Mocks network request using [`browserContext.route`][26] of Playwright
+Mocks network request using [`browserContext.route`][29] of Playwright
 
 ```js
 I.mockRoute(/(.png$)|(.jpg$)/, route => route.abort());
 ```
 
-This method allows intercepting and mocking requests & responses. [Learn more about it][27]
+This method allows intercepting and mocking requests & responses. [Learn more about it][30]
 
 #### Parameters
 
@@ -1458,7 +1484,7 @@ Open new tab and automatically switched to new tab
 I.openNewTab();
 ```
 
-You can pass in [page options][28] to emulate device on this page
+You can pass in [page options][31] to emulate device on this page
 
 ```js
 // enable mobile
@@ -1473,7 +1499,7 @@ I.openNewTab({ isMobile: true });
 
 Presses a key in the browser (on a focused element).
 
-_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][29].
+_Hint:_ For populating text field or textarea, it is recommended to use [`fillField`][32].
 
 ```js
 I.pressKey('Backspace');
@@ -1534,13 +1560,13 @@ Some of the supported key names are:
 
 -   `key` **([string][8] | [Array][10]<[string][8]>)** key or array of keys to press.
 
-Returns **[Promise][9]<void>** automatically synchronized promise through #recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][30]).
+Returns **[Promise][9]<void>** automatically synchronized promise through #recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/Puppeteer#1313][33]).
 
 ### pressKeyDown
 
 Presses a key in the browser and leaves it in a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][31]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][34]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1558,7 +1584,7 @@ Returns **[Promise][9]<void>** automatically synchronized promise through #re
 
 Releases a key in the browser which was previously set to a down state.
 
-To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][31]).
+To make combinations with modifier key and user operation (e.g. `'Control'` + [`click`][34]).
 
 ```js
 I.pressKeyDown('Control');
@@ -1667,7 +1693,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
 #### Parameters
 
 -   `fileName` **[string][8]** file name to save.
--   `fullPage` **[boolean][32]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
+-   `fullPage` **[boolean][25]** (optional, `false` by default) flag to enable fullscreen screenshot mode. 
 
 Returns **[Promise][9]<void>** automatically synchronized promise through #recorder
 
@@ -2174,7 +2200,7 @@ I.switchToPreviousTab(2);
 
 Types out the given text into an active field.
 To slow down typing use a second parameter, to set interval between key presses.
-_Note:_ Should be used when [`fillField`][29] is not an option.
+_Note:_ Should be used when [`fillField`][32] is not an option.
 
 ```js
 // passing in a string
@@ -2217,7 +2243,7 @@ I.uncheckOption('agree', '//form');
 -   `context` **([string][8]? | [object][5])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
 -   `options`   
 
-Returns **[Promise][9]<void>** automatically synchronized promise through #recorder[Additional options][33] for uncheck available as 3rd argument.Examples:```js
+Returns **[Promise][9]<void>** automatically synchronized promise through #recorder[Additional options][35] for uncheck available as 3rd argument.Examples:```js
 // click on element at position
 I.uncheckOption('Agree', '.signup', { position: { x: 5, y: 5 } })
 ```> ⚠️ To avoid flakiness, option `force: true` is set by default
@@ -2229,7 +2255,7 @@ Use Playwright API inside a test.
 First argument is a description of an action.
 Second argument is async function that gets this helper as parameter.
 
-{ [`page`][34], [`browserContext`][35] [`browser`][36] } objects from Playwright API are available.
+{ [`page`][36], [`browserContext`][37] [`browser`][38] } objects from Playwright API are available.
 
 ```js
 I.usePlaywrightTo('emulate offline mode', async ({ browserContext }) => {
@@ -2362,7 +2388,7 @@ Returns **[Promise][9]<void>** automatically synchronized promise through #re
 
 Waits for navigation to finish. By default, it takes configured `waitForNavigation` option.
 
-See [Playwright's reference][37]
+See [Playwright's reference][39]
 
 #### Parameters
 
@@ -2419,7 +2445,7 @@ Returns **[Promise][9]<void>** automatically synchronized promise through #re
 
 Waits for page navigates to a new URL or reloads. By default, it takes configured `waitForNavigation` option.
 
-See [Playwright's reference][38]
+See [Playwright's reference][40]
 
 #### Parameters
 
@@ -2456,7 +2482,7 @@ I.waitForVisible('#popup');
 -   `locator` **([string][8] | [object][5])** element located by CSS|XPath|strict locator.
 -   `sec` **[number][20]** (optional, `1` by default) time in seconds to wait 
 
-Returns **[Promise][9]<void>** automatically synchronized promise through #recorderThis method accepts [React selectors][39].
+Returns **[Promise][9]<void>** automatically synchronized promise through #recorderThis method accepts [React selectors][41].
 
 ### waitInUrl
 
@@ -2567,44 +2593,48 @@ Returns **[Promise][9]<void>** automatically synchronized promise through #re
 
 [23]: https://playwright.dev/docs/api/class-consolemessage
 
-[24]: https://codecept.io/helpers/FileSystem
+[24]: https://playwright.dev/docs/api/class-locator#locator-is-checked
+
+[25]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+
+[26]: https://playwright.dev/docs/api/class-locator#locator-is-disabled
 
-[25]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
+[27]: https://codecept.io/helpers/FileSystem
 
-[26]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
+[28]: https://playwright.dev/docs/api/class-apirequestcontext#api-request-context-get
 
-[27]: https://playwright.dev/docs/network#handle-requests
+[29]: https://playwright.dev/docs/api/class-browsercontext#browser-context-route
 
-[28]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
+[30]: https://playwright.dev/docs/network#handle-requests
 
-[29]: #fillfield
+[31]: https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions
 
-[30]: https://github.com/GoogleChrome/puppeteer/issues/1313
+[32]: #fillfield
 
-[31]: #click
+[33]: https://github.com/GoogleChrome/puppeteer/issues/1313
 
-[32]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
+[34]: #click
 
-[33]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
+[35]: https://playwright.dev/docs/api/class-elementhandle#element-handle-uncheck
 
-[34]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
+[36]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md
 
-[35]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
+[37]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md
 
-[36]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
+[38]: https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md
 
-[37]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
+[39]: https://playwright.dev/docs/api/class-page?_highlight=waitfornavi#pagewaitfornavigationoptions
 
-[38]: https://playwright.dev/docs/api/class-page#page-wait-for-url
+[40]: https://playwright.dev/docs/api/class-page#page-wait-for-url
 
-[39]: https://codecept.io/react
+[41]: https://codecept.io/react
 
-[40]: https://playwright.dev/docs/api/class-browsercontext
+[42]: https://playwright.dev/docs/api/class-browsercontext
 
-[41]: https://playwright.dev/docs/api/class-page#page-set-default-timeout
+[43]: https://playwright.dev/docs/api/class-page#page-set-default-timeout
 
-[42]: https://playwright.dev/docs/trace-viewer
+[44]: https://playwright.dev/docs/trace-viewer
 
-[43]: https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge
+[45]: https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge
 
-[44]: https://playwright.dev/docs/api/class-consolemessage#console-message-type
+[46]: https://playwright.dev/docs/api/class-consolemessage#console-message-type

package/docs/helpers/Puppeteer.md

@@ -44,6 +44,8 @@ Type: [object][4]
 -   `disableScreenshots` **[boolean][20]?** don't save screenshot on failure.
 -   `fullPageScreenshots` **[boolean][20]?** make full page screenshots on failure.
 -   `uniqueScreenshotNames` **[boolean][20]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
+-   `trace` **[boolean][20]?** record [tracing information][25] with screenshots.
+-   `keepTraceForPassedTests` **[boolean][20]?** save trace for passed tests.
 -   `keepBrowserState` **[boolean][20]?** keep browser state between tests when `restart` is set to false.
 -   `keepCookies` **[boolean][20]?** keep cookies between tests when `restart` is set to false.
 -   `waitForAction` **[number][11]?** how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
@@ -55,11 +57,19 @@ Type: [object][4]
 -   `userAgent` **[string][6]?** user-agent string.
 -   `manualStart` **[boolean][20]?** do not start browser before a test, start it manually inside a helper with `this.helpers["Puppeteer"]._startBrowser()`.
 -   `browser` **[string][6]?** can be changed to `firefox` when using [puppeteer-firefox][2].
--   `chrome` **[object][4]?** pass additional [Puppeteer run options][25].
+-   `chrome` **[object][4]?** pass additional [Puppeteer run options][26].
 -   `highlightElement` **[boolean][20]?** highlight the interacting elements. Default: false. Note: only activate under verbose mode (--verbose).
 
 
 
+#### Trace Recording Customization
+
+Trace recording provides complete information on test execution and includes screenshots, and network requests logged during run.
+Traces will be saved to `output/trace`
+
+-   `trace`: enables trace recording for failed tests; trace are saved into `output/trace` folder
+-   `keepTraceForPassedTests`: - save trace for passed tests
+
 #### Example #1: Wait for 0 network connections.
 
 ```js
@@ -2263,4 +2273,6 @@ Returns **[Promise][7]<void>** automatically synchronized promise through #re
 
 [24]: https://codecept.io/react
 
-[25]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions
+[25]: https://pptr.dev/api/puppeteer.tracing
+
+[26]: https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#puppeteerlaunchoptions

package/docs/webdriver.md

@@ -447,7 +447,7 @@ To share the same user session across different tests CodeceptJS provides [autoL
 This plugin requires some configuration but is very simple in use:
 
 ```js
-Scenario('do something with logged in user', ({ I, login) }) => {
+Scenario('do something with logged in user', ({ I, login }) => {
   login('user');
   I.see('Dashboard','h1');
 });

package/lib/ai.js

@@ -16,8 +16,6 @@ const htmlConfig = {
   html: {},
 };
 
-const aiInstance = null;
-
 class AiAssistant {
   constructor() {
     this.config = config.get('ai', defaultConfig);
@@ -28,10 +26,7 @@ class AiAssistant {
 
     this.isEnabled = !!process.env.OPENAI_API_KEY;
 
-    if (!this.isEnabled) {
-      debug('No OpenAI API key provided. AI assistant is disabled.');
-      return;
-    }
+    if (!this.isEnabled) return;
 
     const configuration = new Configuration({
       apiKey: process.env.OPENAI_API_KEY,
@@ -40,17 +35,13 @@ class AiAssistant {
     this.openai = new OpenAIApi(configuration);
   }
 
-  static getInstance() {
-    return aiInstance || new AiAssistant();
-  }
-
-  async setHtmlContext(html) {
+  setHtmlContext(html) {
     let processedHTML = html;
 
     if (this.htmlConfig.simplify) {
       processedHTML = removeNonInteractiveElements(processedHTML, this.htmlConfig);
     }
-    if (this.htmlConfig.minify) processedHTML = await minifyHtml(processedHTML);
+    if (this.htmlConfig.minify) processedHTML = minifyHtml(processedHTML);
     if (this.htmlConfig.maxLength) processedHTML = splitByChunks(processedHTML, this.htmlConfig.maxLength)[0];
 
     debug(processedHTML);

package/lib/helper/Appium.js

@@ -183,6 +183,11 @@ class Appium extends Webdriver {
     this.axios = axios.create();
 
     webdriverio = require('webdriverio');
+    if (!config.appiumV2) {
+      console.log('The Appium core team does not maintain Appium 1.x anymore since the 1st of January 2022. Please migrating to Appium 2.x by adding appiumV2: true to your config.');
+      console.log('More info: https://bit.ly/appium-v2-migration');
+      console.log('This Appium 1.x support will be removed in next major release.');
+    }
   }
 
   _validateConfig(config) {
@@ -916,11 +921,12 @@ class Appium extends Webdriver {
    * I.setNetworkConnection(4) // airplane mode off, wifi off, data on
    * I.setNetworkConnection(6) // airplane mode off, wifi on, data on
    * ```
-   * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setNetworkConnection.html).
-   *
-   * @return {Promise<{}>}
+   * See corresponding [webdriverio reference](https://webdriver.io/docs/api/chromium/#setnetworkconnection).
    *
    * Appium: support only Android
+   *
+   * @param {number} value The network connection mode bitmask
+   * @return {Promise<number>}
    */
   async setNetworkConnection(value) {
     onlyForApps.call(this, supportedPlatform.android);

package/lib/helper/Playwright.js

@@ -116,6 +116,10 @@ const config = {};
  * npm i playwright-core@^1.18 --save
  * ```
  *
+ * Breaking Changes: if you use Playwright v1.38 and later, it will no longer download browsers automatically.
+ *
+ * Run `npx playwright install` to download browsers after `npm install`.
+ *
  * Using playwright-core package, will prevent the download of browser binaries and allow connecting to an existing browser installation or for connecting to a remote one.
  *
  *
@@ -993,6 +997,38 @@ class Playwright extends Helper {
     await el.blur(options);
     return this._waitForAction();
   }
+  /**
+   * Return the checked status of given element.
+   *
+   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {object} [options] See https://playwright.dev/docs/api/class-locator#locator-is-checked
+   * @return {Promise<boolean>}
+   *
+   */
+
+  async grabCheckedElementStatus(locator, options = {}) {
+    const supportedTypes = ['checkbox', 'radio'];
+    const el = await this._locateElement(locator);
+    const type = await el.getAttribute('type');
+
+    if (supportedTypes.includes(type)) {
+      return el.isChecked(options);
+    }
+    throw new Error(`Element is not a ${supportedTypes.join(' or ')} input`);
+  }
+  /**
+   * Return the disabled status of given element.
+   *
+   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {object} [options] See https://playwright.dev/docs/api/class-locator#locator-is-disabled
+   * @return {Promise<boolean>}
+   *
+   */
+
+  async grabDisabledElementStatus(locator, options = {}) {
+    const el = await this._locateElement(locator);
+    return el.isDisabled(options);
+  }
 
   /**
    * {{> dragAndDrop }}
@@ -2546,6 +2582,7 @@ class Playwright extends Helper {
       let count = 0;
       do {
         waiter = await _contextObject.locator(`:has-text('${text}')`).first().isVisible();
+        if (waiter) break;
         await this.wait(1);
         count += 1000;
       } while (count <= waitTimeout);

package/lib/helper/Puppeteer.js

@@ -4,6 +4,7 @@ const fsExtra = require('fs-extra');
 const path = require('path');
 
 const Helper = require('@codeceptjs/helper');
+const { v4: uuidv4 } = require('uuid');
 const Locator = require('../locator');
 const recorder = require('../recorder');
 const store = require('../store');
@@ -19,6 +20,7 @@ const {
   fileExists,
   chunkArray,
   toCamelCase,
+  clearString,
   convertCssPropertiesToCamelCase,
   screenshotOutputFolder,
   getNormalizedKeyAttributeValue,
@@ -57,6 +59,8 @@ const consoleLogStore = new Console();
  * @prop {boolean} [disableScreenshots=false]  - don't save screenshot on failure.
  * @prop {boolean} [fullPageScreenshots=false] - make full page screenshots on failure.
  * @prop {boolean} [uniqueScreenshotNames=false]  - option to prevent screenshot override if you have scenarios with the same name in different suites.
+ * @prop {boolean} [trace=false] - record [tracing information](https://pptr.dev/api/puppeteer.tracing) with screenshots.
+ * @prop {boolean} [keepTraceForPassedTests=false] - save trace for passed tests.
  * @prop {boolean} [keepBrowserState=false] - keep browser state between tests when `restart` is set to false.
  * @prop {boolean} [keepCookies=false] - keep cookies between tests when `restart` is set to false.
  * @prop {number} [waitForAction=100] - how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
@@ -92,6 +96,14 @@ const config = {};
  *
  * <!-- configuration -->
  *
+ * #### Trace Recording Customization
+ *
+ * Trace recording provides complete information on test execution and includes screenshots, and network requests logged during run.
+ * Traces will be saved to `output/trace`
+ *
+ * * `trace`: enables trace recording for failed tests; trace are saved into `output/trace` folder
+ * * `keepTraceForPassedTests`: - save trace for passed tests
+ *
  * #### Example #1: Wait for 0 network connections.
  *
  * ```js
@@ -281,8 +293,9 @@ class Puppeteer extends Helper {
     }
   }
 
-  async _before() {
+  async _before(test) {
     this.sessionPages = {};
+    this.currentRunningTest = test;
     recorder.retry({
       retries: 3,
       when: err => {
@@ -647,6 +660,14 @@ class Puppeteer extends Helper {
       }
     }
 
+    if (this.options.trace) {
+      const fileName = `${`${global.output_dir}${path.sep}trace${path.sep}${uuidv4()}_${clearString(this.currentRunningTest.title)}`.slice(0, 245)}.json`;
+      const dir = path.dirname(fileName);
+      if (!fileExists(dir)) fs.mkdirSync(dir);
+      await this.page.tracing.start({ screenshots: true, path: fileName });
+      this.currentRunningTest.artifacts.trace = fileName;
+    }
+
     await this.page.goto(url, { waitUntil: this.options.waitForNavigation });
 
     const performanceTiming = JSON.parse(await this.page.evaluate(() => JSON.stringify(window.performance.timing)));
@@ -1898,8 +1919,30 @@ class Puppeteer extends Helper {
     }
   }
 
-  async _failed() {
+  async _failed(test) {
+    await this._withinEnd();
+
+    if (this.options.trace) {
+      await this.page.tracing.stop();
+      const _traceName = this.currentRunningTest.artifacts.trace.replace('.json', '.failed.json');
+      fs.renameSync(this.currentRunningTest.artifacts.trace, _traceName);
+      test.artifacts.trace = _traceName;
+    }
+  }
+
+  async _passed(test) {
     await this._withinEnd();
+
+    if (this.options.trace) {
+      await this.page.tracing.stop();
+      if (this.options.keepTraceForPassedTests) {
+        const _traceName = this.currentRunningTest.artifacts.trace.replace('.json', '.passed.json');
+        fs.renameSync(this.currentRunningTest.artifacts.trace, _traceName);
+        test.artifacts.trace = _traceName;
+      } else {
+        fs.unlinkSync(this.currentRunningTest.artifacts.trace);
+      }
+    }
   }
 
   /**

package/lib/html.js

@@ -1,7 +1,7 @@
 const { parse, serialize } = require('parse5');
-const { minify } = require('html-minifier-terser');
+const { minify } = require('html-minifier');
 
-async function minifyHtml(html) {
+function minifyHtml(html) {
   return minify(html, {
     collapseWhitespace: true,
     removeComments: true,
@@ -11,7 +11,7 @@ async function minifyHtml(html) {
     removeStyleLinkTypeAttributes: true,
     collapseBooleanAttributes: true,
     useShortDoctype: true,
-  });
+  }).toString();
 }
 
 const defaultHtmlOpts = {

package/lib/pause.js

@@ -18,7 +18,8 @@ let nextStep;
 let finish;
 let next;
 let registeredVariables = {};
-let aiAssistant;
+const aiAssistant = new AiAssistant();
+
 /**
  * Pauses test execution and starts interactive shell
  * @param {Object<string, *>} [passedObject]
@@ -44,8 +45,6 @@ function pauseSession(passedObject = {}) {
     let vars = Object.keys(registeredVariables).join(', ');
     if (vars) vars = `(vars: ${vars})`;
 
-    aiAssistant = AiAssistant.getInstance();
-
     output.print(colors.yellow(' Interactive shell started'));
     output.print(colors.yellow(' Use JavaScript syntax to try steps in action'));
     output.print(colors.yellow(` - Press ${colors.bold('ENTER')} to run the next step`));
@@ -103,9 +102,7 @@ async function parseInput(cmd) {
   let isAiCommand = false;
   let $res;
   try {
-    // eslint-disable-next-line
     const locate = global.locate; // enable locate in this context
-    // eslint-disable-next-line
     const I = container.support('I');
     if (cmd.trim().startsWith('=>')) {
       isCustomCommand = true;
@@ -118,7 +115,7 @@ async function parseInput(cmd) {
       executeCommand = executeCommand.then(async () => {
         try {
           const html = await res;
-          await aiAssistant.setHtmlContext(html);
+          aiAssistant.setHtmlContext(html);
         } catch (err) {
           output.print(output.styles.error(' ERROR '), 'Can\'t get HTML context', err.stack);
           return;

package/lib/plugin/autoLogin.js

@@ -9,6 +9,7 @@ const isAsyncFunction = require('../utils').isAsyncFunction;
 
 const defaultUser = {
   fetch: I => I.grabCookie(),
+  check: () => {},
   restore: (I, cookies) => {
     I.amOnPage('/'); // open a page
     I.setCookie(cookies);
@@ -283,7 +284,12 @@ module.exports = function (config) {
       } else {
         userSession.login(I);
       }
+
       const cookies = await userSession.fetch(I);
+      if (!cookies) {
+        debug('Cannot save user session with empty cookies from auto login\'s fetch method');
+        return;
+      }
       if (config.saveToFile) {
         debug(`Saved user session into file for ${name}`);
         fs.writeFileSync(path.join(global.output_dir, `${name}_session.json`), JSON.stringify(cookies));