codeceptjs 3.3.8-beta.1 → 3.4.0

package/docs/build/GraphQLDataFactory.js

@@ -1,6 +1,6 @@
 const path = require('path');
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const GraphQL = require('./GraphQL');
 
 /**
@@ -46,8 +46,8 @@ const GraphQL = require('./GraphQL');
  * ```js
  * // tests/factories/users.js
  *
- * const Factory = require('rosie').Factory;
- * const faker = require('@faker-js/faker');
+ * const { Factory } = require('rosie').Factory;
+ * const { faker } = require('@faker-js/faker');
  *
  * // Used with a constructor function passed to Factory, so that the final build
  * // object matches the necessary pattern to be sent as the variables object.

package/docs/build/JSONResponse.js

@@ -2,7 +2,7 @@ const assert = require('assert');
 const chai = require('chai');
 const joi = require('joi');
 const chaiDeepMatch = require('chai-deep-match');
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 
 chai.use(chaiDeepMatch);
 

package/docs/build/Mochawesome.js

@@ -2,7 +2,7 @@ let addMochawesomeContext;
 let currentTest;
 let currentSuite;
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const { clearString } = require('../utils');
 
 class Mochawesome extends Helper {

package/docs/build/Nightmare.js

@@ -2,7 +2,7 @@ const path = require('path');
 
 const urlResolve = require('url').resolve;
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const { includes: stringIncludes } = require('../assert/include');
 const { urlEquals } = require('../assert/equal');
 const { equals } = require('../assert/equal');

package/docs/build/Playwright.js

@@ -1,7 +1,7 @@
 const path = require('path');
 const fs = require('fs');
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const Locator = require('../locator');
 const recorder = require('../recorder');
 const stringIncludes = require('../assert/include').includes;
@@ -66,6 +66,7 @@ const pathSeparator = path.sep;
  * @prop {boolean} [video=false] - enables video recording for failed tests; videos are saved into `output/videos` folder
  * @prop {boolean} [keepVideoForPassedTests=false] - save videos for passed tests; videos are saved into `output/videos` folder
  * @prop {boolean} [trace=false] - record [tracing information](https://playwright.dev/docs/trace-viewer) with screenshots and snapshots.
+ * @prop {boolean} [keepTraceForPassedTests=false] - save trace for passed tests.
  * @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} [keepBrowserState=false] - keep browser state between tests when `restart` is set to 'session'.
@@ -1413,7 +1414,7 @@ class Playwright extends Helper {
    *
    * ```
    *
-   * @param {string} [fileName] set filename for downloaded file
+   * @param {string} fileName set filename for downloaded file
    * @return {Promise<void>}
    */
   async handleDownloads(fileName) {
@@ -3968,7 +3969,7 @@ async function refreshContextSession() {
 
 async function saveVideoForPage(page, name) {
   if (!page.video()) return null;
-  const fileName = `${global.output_dir}${pathSeparator}videos${pathSeparator}${Date.now()}_${clearString(name).slice(0, 245)}.webm`;
+  const fileName = `${`${global.output_dir}${pathSeparator}videos${pathSeparator}${Date.now()}_${clearString(name)}`.slice(0, 245)}.webm`;
   page.video().saveAs(fileName).then(() => {
     if (!page) return;
     page.video().delete().catch(e => {});

package/docs/build/Protractor.js

@@ -6,7 +6,7 @@ let ProtractorExpectedConditions;
 
 const path = require('path');
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const stringIncludes = require('../assert/include').includes;
 const { urlEquals, equals } = require('../assert/equal');
 const { empty } = require('../assert/empty');

package/docs/build/Puppeteer.js

@@ -3,7 +3,7 @@ const fs = require('fs');
 const fsExtra = require('fs-extra');
 const path = require('path');
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const Locator = require('../locator');
 const recorder = require('../recorder');
 const stringIncludes = require('../assert/include').includes;

package/docs/build/REST.js

@@ -1,7 +1,7 @@
 const axios = require('axios').default;
+const Helper = require('@codeceptjs/helper');
 const Secret = require('../secret');
 
-const Helper = require('../helper');
 const { beautify } = require('../utils');
 
 /**

package/docs/build/TestCafe.js

@@ -6,6 +6,7 @@ const qrcode = require('qrcode-terminal');
 const createTestCafe = require('testcafe');
 const { Selector, ClientFunction } = require('testcafe');
 
+const Helper = require('@codeceptjs/helper');
 const ElementNotFound = require('./errors/ElementNotFound');
 const testControllerHolder = require('./testcafe/testControllerHolder');
 const {
@@ -22,7 +23,6 @@ const {
   xpathLocator,
 } = require('../utils');
 const Locator = require('../locator');
-const Helper = require('../helper');
 
 /**
  * Client Functions
@@ -766,8 +766,8 @@ class TestCafe extends Helper {
 
     // TODO As far as I understand the testcafe docs this should do a multi-select
     // but it does not work
-    const clickOpts = { ctrl: option.length > 1 };
-    await this.t.click(el, clickOpts).catch(mapError);
+    // const clickOpts = { ctrl: option.length > 1 };
+    await this.t.click(el).catch(mapError);
 
     for (const key of option) {
       const opt = key;
@@ -776,7 +776,7 @@ class TestCafe extends Helper {
       try {
         optEl = el.child('option').withText(opt);
         if (await optEl.count) {
-          await this.t.click(optEl, clickOpts).catch(mapError);
+          await this.t.click(optEl).catch(mapError);
           continue;
         }
         // eslint-disable-next-line no-empty
@@ -787,7 +787,7 @@ class TestCafe extends Helper {
         const sel = `[value="${opt}"]`;
         optEl = el.find(sel);
         if (await optEl.count) {
-          await this.t.click(optEl, clickOpts).catch(mapError);
+          await this.t.click(optEl).catch(mapError);
         }
         // eslint-disable-next-line no-empty
       } catch (err) {

package/docs/build/WebDriver.js

@@ -4,12 +4,12 @@ const assert = require('assert');
 const path = require('path');
 const fs = require('fs');
 
-const Helper = require('../helper');
+const Helper = require('@codeceptjs/helper');
 const stringIncludes = require('../assert/include').includes;
 const { urlEquals, equals } = require('../assert/equal');
 const { debug } = require('../output');
-const empty = require('../assert/empty').empty;
-const truth = require('../assert/truth').truth;
+const { empty } = require('../assert/empty');
+const { truth } = require('../assert/truth');
 const {
   xpathLocator,
   fileExists,
@@ -31,8 +31,6 @@ const Locator = require('../locator');
 const SHADOW = 'shadow';
 const webRoot = 'body';
 
-let version;
-
 /**
  * ## Configuration
  *
@@ -266,7 +264,7 @@ const config = {};
  * ```js
  * plugins: {
  *    wdio: {
-  *       enabled: true,
+ *       enabled: true,
  *        services: ['sauce'],
  *        user: ... ,// saucelabs username
  *        key: ... // saucelabs api key
@@ -294,7 +292,7 @@ const config = {};
  * ```js
  * plugins: {
  *    wdio: {
-  *       enabled: true,
+ *       enabled: true,
  *        services: ['browserstack'],
  *        user: ... ,// browserstack username
  *        key: ... // browserstack api key
@@ -386,16 +384,6 @@ class WebDriver extends Helper {
     super(config);
     webdriverio = require('webdriverio');
 
-    try {
-      version = JSON.parse(fs.readFileSync(path.join(require.resolve('webdriverio'), '/../../', 'package.json')).toString()).version;
-    } catch (err) {
-      this.debug('Can\'t detect webdriverio version, assuming webdriverio v6 is used');
-    }
-
-    if (isWebDriver5()) {
-      console.log('DEPRECATION NOTICE:');
-      console.log('You are using webdriverio v5. It is recommended to update to webdriverio@6.\nSupport of webdriverio v5 is deprecated and will be removed in CodeceptJS 3.0\n');
-    }
     // set defaults
     this.root = webRoot;
     this.isWeb = true;
@@ -661,23 +649,23 @@ class WebDriver extends Helper {
   }
 
   /**
-  * Use [webdriverio](https://webdriver.io/docs/api.html) API inside a test.
-  *
-  * First argument is a description of an action.
-  * Second argument is async function that gets this helper as parameter.
-  *
-  * { [`browser`](https://webdriver.io/docs/api.html)) } object from WebDriver API is available.
-  *
-  * ```js
-  * I.useWebDriverTo('open multiple windows', async ({ browser }) {
-  *    // create new window
-  *    await browser.newWindow('https://webdriver.io');
-  * });
-  * ```
-  *
-  * @param {string} description used to show in logs.
-  * @param {function} fn async functuion that executed with WebDriver helper as argument
-  */
+   * Use [webdriverio](https://webdriver.io/docs/api.html) API inside a test.
+   *
+   * First argument is a description of an action.
+   * Second argument is async function that gets this helper as parameter.
+   *
+   * { [`browser`](https://webdriver.io/docs/api.html)) } object from WebDriver API is available.
+   *
+   * ```js
+   * I.useWebDriverTo('open multiple windows', async ({ browser }) {
+   *    // create new window
+   *    await browser.newWindow('https://webdriver.io');
+   * });
+   * ```
+   *
+   * @param {string} description used to show in logs.
+   * @param {function} fn async functuion that executed with WebDriver helper as argument
+   */
   useWebDriverTo(description, fn) {
     return this._useTo(...arguments);
   }
@@ -2291,7 +2279,6 @@ class WebDriver extends Helper {
     const res = await this._locate(withStrictLocator(locator), true);
     assertElementExists(res, locator);
     const elem = usingFirstElement(res);
-    if (isWebDriver5()) return elem.moveTo(xOffset, yOffset);
     return elem.moveTo({ xOffset, yOffset });
   }
 
@@ -2923,19 +2910,7 @@ class WebDriver extends Helper {
    */
   async waitForEnabled(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
-        if (!res || res.length === 0) {
-          return false;
-        }
-        const selected = await forEachAsync(res, async el => this.browser.isElementEnabled(getElementId(el)));
-        if (Array.isArray(selected)) {
-          return selected.filter(val => val === true).length > 0;
-        }
-        return selected;
-      }, aSec * 1000, `element (${new Locator(locator)}) still not enabled after ${aSec} sec`);
-    }
+
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       if (!res || res.length === 0) {
@@ -2968,12 +2943,7 @@ class WebDriver extends Helper {
    */
   async waitForElement(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
-        return res && res.length;
-      }, aSec * 1000, `element (${(new Locator(locator))}) still not present on page after ${aSec} sec`);
-    }
+
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       return res && res.length;
@@ -3022,20 +2992,7 @@ class WebDriver extends Helper {
     const client = this.browser;
     const aSec = sec || this.options.waitForTimeoutInSeconds;
     let currUrl = '';
-    if (isWebDriver5()) {
-      return client
-        .waitUntil(function () {
-          return this.getUrl().then((res) => {
-            currUrl = decodeUrl(res);
-            return currUrl.indexOf(urlPart) > -1;
-          });
-        }, aSec * 1000).catch((e) => {
-          if (e.message.indexOf('timeout')) {
-            throw new Error(`expected url to include ${urlPart}, but found ${currUrl}`);
-          }
-          throw e;
-        });
-    }
+
     return client
       .waitUntil(function () {
         return this.getUrl().then((res) => {
@@ -3103,20 +3060,6 @@ class WebDriver extends Helper {
   async waitForText(text, sec = null, context = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
     const _context = context || this.root;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(
-        async () => {
-          const res = await this.$$(withStrictLocator.call(this, _context));
-          if (!res || res.length === 0) return false;
-          const selected = await forEachAsync(res, async el => this.browser.getElementText(getElementId(el)));
-          if (Array.isArray(selected)) {
-            return selected.filter(part => part.indexOf(text) >= 0).length > 0;
-          }
-          return selected.indexOf(text) >= 0;
-        }, aSec * 1000,
-        `element (${_context}) is not in DOM or there is no element(${_context}) with text "${text}" after ${aSec} sec`,
-      );
-    }
 
     return this.browser.waitUntil(
       async () => {
@@ -3150,20 +3093,7 @@ class WebDriver extends Helper {
   async waitForValue(field, value, sec = null) {
     const client = this.browser;
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return client.waitUntil(
-        async () => {
-          const res = await findFields.call(this, field);
-          if (!res || res.length === 0) return false;
-          const selected = await forEachAsync(res, async el => el.getValue());
-          if (Array.isArray(selected)) {
-            return selected.filter(part => part.indexOf(value) >= 0).length > 0;
-          }
-          return selected.indexOf(value) >= 0;
-        }, aSec * 1000,
-        `element (${field}) is not in DOM or there is no element(${field}) with value "${value}" after ${aSec} sec`,
-      );
-    }
+
     return client.waitUntil(
       async () => {
         const res = await findFields.call(this, field);
@@ -3196,17 +3126,7 @@ class WebDriver extends Helper {
    */
   async waitForVisible(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
-        if (!res || res.length === 0) return false;
-        const selected = await forEachAsync(res, async el => el.isDisplayed());
-        if (Array.isArray(selected)) {
-          return selected.filter(val => val === true).length > 0;
-        }
-        return selected;
-      }, aSec * 1000, `element (${new Locator(locator)}) still not visible after ${aSec} sec`);
-    }
+
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       if (!res || res.length === 0) return false;
@@ -3233,17 +3153,7 @@ class WebDriver extends Helper {
    */
   async waitNumberOfVisibleElements(locator, num, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
-        if (!res || res.length === 0) return false;
-        let selected = await forEachAsync(res, async el => el.isDisplayed());
 
-        if (!Array.isArray(selected)) selected = [selected];
-        selected = selected.filter(val => val === true);
-        return selected.length === num;
-      }, aSec * 1000, `The number of elements (${new Locator(locator)}) is not ${num} after ${aSec} sec`);
-    }
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       if (!res || res.length === 0) return false;
@@ -3270,14 +3180,7 @@ class WebDriver extends Helper {
    */
   async waitForInvisible(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this.$$(withStrictLocator(locator));
-        if (!res || res.length === 0) return true;
-        const selected = await forEachAsync(res, async el => el.isDisplayed());
-        return !selected.length;
-      }, aSec * 1000, `element (${new Locator(locator)}) still visible after ${aSec} sec`);
-    }
+
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       if (!res || res.length === 0) return true;
@@ -3318,15 +3221,7 @@ class WebDriver extends Helper {
    */
   async waitForDetached(locator, sec = null) {
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => {
-        const res = await this._res(locator);
-        if (!res || res.length === 0) {
-          return true;
-        }
-        return false;
-      }, aSec * 1000, `element (${new Locator(locator)}) still on page after ${aSec} sec`);
-    }
+
     return this.browser.waitUntil(async () => {
       const res = await this._res(locator);
       if (!res || res.length === 0) {
@@ -3367,9 +3262,7 @@ class WebDriver extends Helper {
     }
 
     const aSec = sec || this.options.waitForTimeoutInSeconds;
-    if (isWebDriver5()) {
-      return this.browser.waitUntil(async () => this.browser.execute(fn, ...args), aSec * 1000, '');
-    }
+
     return this.browser.waitUntil(async () => this.browser.execute(fn, ...args), { timeout: aSec * 1000, timeoutMsg: '' });
   }
 
@@ -3418,18 +3311,6 @@ class WebDriver extends Helper {
     let target;
     const current = await this.browser.getWindowHandle();
 
-    if (isWebDriver5()) {
-      await this.browser.waitUntil(async () => {
-        await this.browser.getWindowHandles().then((handles) => {
-          if (handles.indexOf(current) + num + 1 <= handles.length) {
-            target = handles[handles.indexOf(current) + num];
-          }
-        });
-        return target;
-      }, aSec * 1000, `There is no ability to switch to next tab with offset ${num}`);
-      return this.browser.switchToWindow(target);
-    }
-
     await this.browser.waitUntil(async () => {
       await this.browser.getWindowHandles().then((handles) => {
         if (handles.indexOf(current) + num + 1 <= handles.length) {
@@ -3459,18 +3340,6 @@ class WebDriver extends Helper {
     const current = await this.browser.getWindowHandle();
     let target;
 
-    if (isWebDriver5()) {
-      await this.browser.waitUntil(async () => {
-        await this.browser.getWindowHandles().then((handles) => {
-          if (handles.indexOf(current) - num > -1) {
-            target = handles[handles.indexOf(current) - num];
-          }
-        });
-        return target;
-      }, aSec * 1000, `There is no ability to switch to previous tab with offset ${num}`);
-      return this.browser.switchToWindow(target);
-    }
-
     await this.browser.waitUntil(async () => {
       await this.browser.getWindowHandles().then((handles) => {
         if (handles.indexOf(current) - num > -1) {
@@ -4145,8 +4014,4 @@ function prepareLocateFn(context) {
   };
 }
 
-function isWebDriver5() {
-  return version && version.indexOf('5') === 0;
-}
-
 module.exports = WebDriver;

package/docs/changelog.md

@@ -7,6 +7,53 @@ layout: Section
 
 # Releases
 
+## 3.4.0
+
+* **Updated to latest mocha and modern Cucumber**
+* **Allure plugin moved to [@codeceptjs/allure-legacy](https://github.com/codeceptjs/allure-legacy) package**. This happened because allure-commons package v1 was not updated and caused vulnarabilities. Fixes [#3422](https://github.com/codeceptjs/CodeceptJS/issues/3422). We don't plan to maintain allure v2 plugin so it's up to community to take this initiative. Current allure plugin will print a warning message without interfering the run, so it won't accidentally fail your builds.
+* Added ability to **[retry Before](https://codecept.io/basics/#retry-before), BeforeSuite, After, AfterSuite** hooks by **[davertmik](https://github.com/davertmik)**:
+```js
+Feature('flaky Before & BeforeSuite', { retryBefore: 2, retryBeforeSuite: 3 })
+```
+
+* **Flexible [retries configuration](https://codecept.io/basics/#retry-configuration) introduced** by **[davertmik](https://github.com/davertmik)**:
+
+```js
+retry: [
+  {
+    // enable this config only for flaky tests
+    grep: '@flaky', 
+    Before: 3 // retry Before 3 times
+    Scenario: 3 // retry Scenario 3 times
+  }, 
+  {
+    // retry less when running slow tests
+    grep: '@slow' 
+    Scenario: 1
+    Before: 1
+  }, {
+    // retry all BeforeSuite 3 times
+    BeforeSuite: 3
+  }
+]
+```
+* **Flexible [timeout configuration](https://codecept.io/advanced/#timeout-configuration)** introduced by **[davertmik](https://github.com/davertmik)**:
+
+```js
+timeout: [
+  10, // default timeout is 10secs  
+  {   // but increase timeout for slow tests
+    grep: '@slow',
+    Feature: 50
+  },
+]
+```
+
+* JsDoc: Removed promise from `I.say`. See [#3535](https://github.com/codeceptjs/CodeceptJS/issues/3535) by **[danielrentz](https://github.com/danielrentz)**
+* **[Playwright]** `handleDownloads` requires now a filename param. See [#3511](https://github.com/codeceptjs/CodeceptJS/issues/3511) by **[PeterNgTr](https://github.com/PeterNgTr)** 
+* **[WebDriver]** Added support for v8, removed support for webdriverio v5 and lower. See [#3578](https://github.com/codeceptjs/CodeceptJS/issues/3578) by **[PeterNgTr](https://github.com/PeterNgTr)**
+
+
 ## 3.3.7
 
 🛩️ Features
@@ -37,8 +84,8 @@ layout: Section
 
 📖 Documentation
 
-* Updated [Auickstart](https://codecept.io/quickstart/) with detailed explanation of questions in init
-* Added [Translation](/translations/) guide
+* Updated [Quickstart](https://codecept.io/quickstart/) with detailed explanation of questions in init
+* Added [Translation](/translation/) guide
 * Updated [TypeScript](https://bit.ly/3XIMq6n) guide for promise-based typings
 * Reordered guides list on a website
 

package/docs/helpers/ApiDataFactory.md

@@ -53,8 +53,8 @@ See the example for Posts factories:
 ```js
 // tests/factories/posts.js
 
-const Factory = require('rosie').Factory;
-const faker = require('@faker-js/faker');
+const { Factory } = require('rosie');
+const { faker } = require('@faker-js/faker');
 
 module.exports = new Factory()
    // no need to set id, it will be set by REST API
@@ -228,8 +228,8 @@ I.have('user', { }, { age: 33, height: 55 })
 #### Parameters
 
 -   `factory` **any** factory to use
--   `params` **any** predefined parameters
--   `options` **any** options for programmatically generate the attributes
+-   `params` **any?** predefined parameters
+-   `options` **any?** options for programmatically generate the attributes
 
 Returns **[Promise][5]<any>** 
 
@@ -252,8 +252,8 @@ I.haveMultiple('post', 3, { author: 'davert' }, { publish_date: '01.01.1997' });
 
 -   `factory` **any** 
 -   `times` **any** 
--   `params` **any** 
--   `options` **any** 
+-   `params` **any?** 
+-   `options` **any?** 
 
 [1]: https://github.com/rosiejs/rosie
 

package/docs/helpers/FileSystem.md

@@ -124,10 +124,10 @@ Checks that file found by `seeFile` includes a text.
 
 ### waitForFile
 
-Waits for file to be present in current directory.
+Waits for the file to be present in the current directory.
 
 ```js
-I.handleDownloads();
+I.handleDownloads('downloads/largeFilesName.txt');
 I.click('Download large File');
 I.amInPath('output/downloads');
 I.waitForFile('largeFilesName.txt', 10); // wait 10 seconds for file

package/docs/helpers/GraphQLDataFactory.md

@@ -53,8 +53,8 @@ See the example for Users factories:
 ```js
 // tests/factories/users.js
 
-const Factory = require('rosie').Factory;
-const faker = require('@faker-js/faker');
+const { Factory } = require('rosie').Factory;
+const { faker } = require('@faker-js/faker');
 
 // Used with a constructor function passed to Factory, so that the final build
 // object matches the necessary pattern to be sent as the variables object.

package/docs/helpers/Playwright.md

@@ -51,6 +51,7 @@ Type: [object][5]
 -   `video` **[boolean][26]?** enables video recording for failed tests; videos are saved into `output/videos` folder
 -   `keepVideoForPassedTests` **[boolean][26]?** save videos for passed tests; videos are saved into `output/videos` folder
 -   `trace` **[boolean][26]?** record [tracing information][35] with screenshots and snapshots.
+-   `keepTraceForPassedTests` **[boolean][26]?** save trace for passed tests.
 -   `fullPageScreenshots` **[boolean][26]?** make full page screenshots on failure.
 -   `uniqueScreenshotNames` **[boolean][26]?** option to prevent screenshot override if you have scenarios with the same name in different suites.
 -   `keepBrowserState` **[boolean][26]?** keep browser state between tests when `restart` is set to 'session'.
@@ -1138,7 +1139,7 @@ I.waitForFile('avatar.jpg', 5);
 
 #### Parameters
 
--   `fileName` **[string][8]?** set filename for downloaded file
+-   `fileName` **[string][8]** set filename for downloaded file
 
 Returns **[Promise][14]<void>** 
 

package/docs/index.md

@@ -86,7 +86,7 @@ Scenario('Checkout test', ({ I }) => {
 Can we use it for long scenarios? Sure!
 
 ```js
-const faker = require('@faker-js/faker');                               // Use 3rd-party JS code
+const { faker } = require('@faker-js/faker');                               // Use 3rd-party JS code
 
 Feature('Store');