codeceptjs 3.5.4-beta.1 → 3.5.5

package/docs/playwright.md

@@ -272,6 +272,29 @@ exports.config = {
 }
 ```
 
+Sometimes, the Electron app is built with [electron-forge](https://www.electronforge.io/), then configuring may a bit different.
+
+- First, you should run your electron-forge command to build and pack your app.
+- Then, you would find `index.js` file inside `.webpack/main/index.js`
+
+`codecept.conf.js` - CodeceptJS configuration file
+```js
+const path = require("path");
+
+exports.config = {
+  helpers: {
+    Playwright: {
+      browser: "electron",
+      electron: {
+        executablePath: require("electron"),
+        args: [path.join(__dirname, ".webpack/main/index.js")],
+      },
+    },
+  },
+  // rest of config
+}
+```
+
 ### Headless Mode
 
 With Electron, headless mode must be set when creating the window. Therefore, CodeceptJS's `show` configuration parameter will not work. However, you can set it in the `main.js` file as shown below:
@@ -606,4 +629,4 @@ Playwright can be added to GitHub Actions using [official action](https://github
 - uses: microsoft/playwright-github-action@v1
 - name: run CodeceptJS tests
   run: npx codeceptjs run
-```
+```

package/docs/webapi/dontSeeInField.mustache

@@ -7,5 +7,5 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
 ```
 
 @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-@param {string} value value to check.
+@param {CodeceptJS.StringOrSecret} value value to check.
 ⚠️ returns a _promise_ which is synchronized internally by recorder

package/docs/webapi/executeAsyncScript.mustache

@@ -21,4 +21,6 @@ let val = await I.executeAsyncScript(function(url, done) {
 
 @param {string|function} fn function to be executed in browser context.
 @param {...any} args to be passed to function.
+@returns {Promise<any>} script return value
+
 ⚠️ returns a _promise_ which is synchronized internally by recorder

package/docs/webapi/executeScript.mustache

@@ -23,4 +23,6 @@ let date = await I.executeScript(function(el) {
 
 @param {string|function} fn function to be executed in browser context.
 @param {...any} args to be passed to function.
+@returns {Promise<any>} script return value
+
 ⚠️ returns a _promise_ which is synchronized internally by recorder

package/docs/webapi/seeInField.mustache

@@ -8,5 +8,5 @@ I.seeInField('form input[type=hidden]','hidden_value');
 I.seeInField('#searchform input','Search');
 ```
 @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-@param {string} value value to check.
+@param {CodeceptJS.StringOrSecret} value value to check.
 ⚠️ returns a _promise_ which is synchronized internally by recorder

package/docs/wiki/Community-Helpers-&-Plugins.md

@@ -22,9 +22,6 @@ Please **add your own** by editing this page.
 * [codeceptjs-bshelper](https://github.com/PeterNgTr/codeceptjs-bshelper) - a helper which updates `Test Names` & `Test Results` on Browserstack 
 * [codeceptjs-tbhelper](https://github.com/testingbot/codeceptjs-tbhelper) - a helper which updates `Test Names` & `Test Results` on TestingBot 
 
-## Integrations
-* [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
-
 ## Visual-Testing
 * [codeceptjs-resemblehelper](https://github.com/puneet0191/codeceptjs-resemblehelper) - a helper which helps with visual testing using resemble.js. 
 * [codeceptjs-applitoolshelper](https://www.npmjs.com/package/codeceptjs-applitoolshelper) - a helper which helps interaction with [Applitools](https://applitools.com)
@@ -33,8 +30,10 @@ Please **add your own** by editing this page.
 ## Reporters
 * [codeceptjs-rphelper](https://github.com/reportportal/agent-js-codecept) is a CodeceptJS helper which can publish tests results on ReportPortal after execution.
 * [codeceptjs-xray-helper](https://www.npmjs.com/package/codeceptjs-xray-helper) is a CodeceptJS helper which can publish tests results on [XRAY](https://confluence.xpand-it.com/display/XRAYCLOUD/Import+Execution+Results+-+REST).
+* [codeceptjs-xray-cloud-helper](https://www.npmjs.com/package/codeceptjs-xray-cloud-helper) is a helper that automatically retrieves the result of CodeceptJS tests and sends them to XRAY/JIRA(cloud version) via [XRAY Cloud API](https://docs.getxray.app/display/XRAYCLOUD/Import+Execution+Results+-+REST+v2#ImportExecutionResultsRESTv2-XrayJSONresults).
 * [codeceptjs-slack-reporter](https://www.npmjs.com/package/codeceptjs-slack-reporter) Get a Slack notification when one or more scenarios fail.
 * [codeceptjs-browserlogs-plugin](https://github.com/pavkam/codeceptjs-browserlogs-plugin) Record the browser logs for failed tests.
+* [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
 
 ## Browser request control
 * [codeceptjs-resources-check](https://github.com/luarmr/codeceptjs-resources-check) Load a URL with Puppeteer and listen to the requests while the page is loading. Enabling count the number or check the sizes of the requests.
@@ -46,4 +45,9 @@ Please **add your own** by editing this page.
 ## Other
 
 * [codeceptjs-cmdhelper](https://github.com/thiagodp/codeceptjs-cmdhelper) allows you to run commands in the terminal/console
-* [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.
+* [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.
+* [codeceptjs-datalayer-helper](https://github.com/kobenguyent/codeceptjs-datalayer-helper) CodeceptJS DataLayer helper helps you to get the datalayer JavaScript array that is used to store information and send this data to the tag manager.
+* [codeceptjs-a11y-helper](https://github.com/kobenguyent/codeceptjs-a11y-helper) accessibility tests integrated with CodeceptJS - Playwright-axe
+* [codeceptjs-lighthouse-helper](https://github.com/kobenguyent/codeceptjs-lighthouse-helper) lighthouse audit integrated with CodeceptJS - Playwright
+* [Snowplow Data analytics](https://www.npmjs.com/package/@viasat/codeceptjs-snowplow-helper) - Test your Snowplow events implementations with CodeceptJS and Snowplow Micro.
+* [codeceptjs-failure-logger](https://github.com/kobenguyent/codeceptjs-failure-logger) - Log failed CodeceptJS tests to file

package/docs/wiki/Converting-Playwright-to-Istanbul-Coverage.md

@@ -5,25 +5,57 @@ To convert coverage generated from `playwright` to `istanbul` coverage, you firs
 
 Once installed, convert the coverage to a format which `istanbul` can recognize, by writing a script as shown below.
 
-```js
-const v8toIstanbul = require('v8-to-istanbul');
-// read all the coverage file from output/coverage folder
-const coverage = require('./output/coverage/Visit_Home_1630335005.coverage.json');
-const fs = require('fs/promises');
+```ts
+import glob from 'glob'
+import v8toIstanbul from 'v8-to-istanbul'
+let coverage
 
-(async () => {
+import fs from 'fs'
+
+const coverageFolder = `${process.cwd()}/coverage`
+
+async function isExists(path) {
+    try {
+        await fs.access(path, null)
+        return true
+    } catch {
+        return false
+    }
+}
+
+glob.sync(process.cwd() + '/output/coverage/**/').forEach(item => {
+    const directory = fs.opendirSync(item)
+    let file
+    while ((file = directory.readSync()) !== null) {
+        if (file && file.name.includes('.coverage.json') === true) {
+            const fileName = file.name
+            if (fileName) {
+                coverage = require(`${process.cwd()}/output/coverage/${fileName}`)
+            }
+        }
+    }
+    directory.closeSync()
+})
+
+void (async () => {
     for (const entry of coverage) {
         // Used to get file name
-        const file = entry.url.match(/(?:http(s)*:\/\/.*\/)(?<file>.*)/);
-        const converter = new v8toIstanbul(file.groups.file, 0, {
-            source: entry.source
-        });
+        const file = entry.url.match(/(?:http(s)*:\/\/.*\/)(?<file>.*)/)
 
-        await converter.load();
-        converter.applyCoverage(entry.functions);
+        const converter = v8toIstanbul(file.groups.file, 0, {
+            source: entry.source,
+        })
+
+        await converter.load()
+        converter.applyCoverage(entry.functions)
 
         // Store converted coverage file which can later be used to generate report
-        await fs.writeFile('./coverage/final.json', JSON.stringify(converter.toIstanbul(), null, 2));
+        const exist = await isExists(coverageFolder)
+        if (!exist) {
+            fs.mkdirSync(coverageFolder, {recursive: true})
+        }
+
+        await fs.writeFileSync(`${coverageFolder}/final.json`, JSON.stringify(converter.toIstanbul(), null, 2))
     }
-})();
+})()
 ```

package/docs/wiki/Examples.md

@@ -6,6 +6,7 @@ Playground repository where you can run tests in different helpers on a basic si
 
 Tests repository demonstrate usage of
 
+* Playwright helper
 * Puppeteer helper
 * WebDriver helper
 * TestCafe plugin
@@ -18,7 +19,6 @@ Tests repository demonstrate usage of
 CodeceptJS repo contains basic tests (both failing and passing) just to show how it works.
 Our team uses it to test new features and run simple scenarios.
 
-
 ## [CodeceptJS Cucumber E2E Framework](https://github.com/gkushang/codeceptjs-e2e)
 
 This repository contains complete E2E framework for CodeceptJS with Cucumber and SauceLabs Integration
@@ -136,4 +136,10 @@ This is necessary if all integrations with TMS and CI/CD are already configured,
 * HTTP request client with session support and unit tests
 * Exemplary code control
 * Ready to launch in a CI/CD system as is
-* OOP, Test data models and builders, endpoint decorators
+* OOP, Test data models and builders, endpoint decorators
+
+## [Playwright fun with CodeceptJS](https://github.com/PeterNgTr/codeceptjs-playwright-fun)
+* Tests are written in TS
+* CI/CD with Github Actions
+* Page Object Model is applied
+* ReportPortal Integration

package/docs/wiki/Migration-to-Appium-v2---CodeceptJS.md

@@ -0,0 +1,83 @@
+# Migrating from Appium 1.x to Appium 2.x
+This document is a guide for those who are using Appium 1.x and wish to migrate to Appium 2.x. It contains a list of breaking changes and how to migrate your environments or test suites to ensure compatibility with Appium 2.0.
+
+# Overview of Appium 2.0
+Appium 2.0 is the most major new release of Appium in over 5 years. The changes in Appium 2.0 are not primarily related to changes in automation behaviors for specific platforms. Instead, Appium 2.0 reenvisions Appium as a platform where "drivers" (code projects that introduce support for automation of a given platform) and "plugins" (code projects that allow for overriding, altering, extending, or adding behaviors to Appium) can be easily created and shared.
+
+At the same time, the Appium project is taking the opportunity to remove many old and deprecated bits of functionality.
+
+Together these do introduce a few breaking changes to how Appium is installed, how drivers and various features are managed, and protocol support. These are detailed below.
+
+# Breaking Changes
+Here we call out the breaking changes and what you need to do to account for them.
+
+## ‼ Default server base path
+With Appium 1.x, the server would accept commands by default on http://localhost:4723/wd/hub. The /wd/hub base path was a legacy convention from the days of migrating from Selenium 1 to Selenium 2, and is no longer relevant. As such the default base path for the server is now /. If you want to retain the old behaviour, you can set the base path via a command line argument as follows:
+
+`appium --base-path=/wd/hub`
+
+## ‼ Installing drivers during setup
+When you installed Appium 1.x, all available drivers would be installed at the same time as the main Appium server. This is no longer the case. Simply installing Appium 2.0 (e.g., by npm install -g appium@next), will install the Appium server only, but no drivers. To install drivers, you must instead use the new [Appium extension CLI](https://appium.github.io/appium/docs/en/2.0/cli/extensions/). For example, to install the latest versions of the XCUITest and UiAutomator2 drivers, after installing Appium you would run the following commands:
+
+```
+appium driver install uiautomator2,xcuitest     # installs the latest driver version  
+```
+At this point, your drivers are installed and ready. There's a lot more you can do with this CLI so be sure to check out the docs on it. If you're running in a CI environment or want to install Appium along with some drivers all in one step, you can do so using some special flags during install, for example:
+
+`npm install --global appium --drivers=xcuitest,uiautomator2`
+This will install Appium and the two drivers for you in one go. Please uninstall any existing Appium 1.x npm packages (with npm uninstall -g appium) if you get an installation or startup error.
+
+## ‼ Capabilities
+One significant difference between old and new protocols is in the format of capabilities. Previously called "desired capabilities", and now called simply "capabilities", there is now a requirement for a so-called "vendor prefix" on any non-standard capabilities. The list of standard capabilities is given in the [WebDriver Protocol spec](https://www.w3.org/TR/webdriver/#capabilities), and includes a few commonly used capabilities such as browserName and platformName.
+
+These standard capabilities continue to be used as-is. All other capabilities must include a "vendor prefix" in their name. A vendor prefix is a string followed by a colon, such as appium:. Most of Appium's capabilities go beyond the standard W3C capabilities and must therefore include vendor prefixes (we recommend that you use appium: unless directed otherwise by documentation). For example:
+
+```
+`appium:app`
+`appium:noReset`
+`appium:deviceName`
+```
+
+This requirement may or may not be a breaking change for your test suites when targeting Appium 2.0. If you're using an updated Appium client (at least one maintained by the Appium team), the client will add the appium: prefix for you on all necessary capabilities automatically. New versions of [Appium Inspector](https://github.com/appium/appium-inspector) will also do this. Cloud-based Appium providers may also do this. So simply be aware that if you get any messages to the effect that your capabilities lack a vendor prefix, this is how you solve that problem.
+
+To make everyone's lives a bit easier with CodeceptJS, you don't need to update your capabilities to include "vendor prefix", CodeceptJS does it for you out of the box.
+
+## ‼ WebdriverIO upgrade
+CodeceptJS should be installed with webdriverio support, as the moment of testing, `webdriverio@8.6.3` works seamlessly:
+```bash
+npm install codeceptjs webdriverio@8.6.3 --save
+```
+
+## ‼ CodeceptJS configuration
+
+```
+...
+        appiumV2: true, // set this to true to try out appium 2.x
+        'app': `${process.cwd()}/build/Monefy_Pro_v1.15.0.apk`,
+        'platform': 'android',
+        'device': 'emulator',
+        'port': DEFAULT_PORT,
+        'path': '/wd/hub',
+        browser: '',
+        desiredCapabilities: {
+            'appPackage': data.packageName,
+            'deviceName': process.env.DEVICE || 'Emulator',
+            'platformName': process.env.PLATFORM || 'android',
+            'platformVersion': process.env.OS_VERSION || '11.0',
+            'automationName': process.env.ENGINE || 'UIAutomator2',
+            'avd': process.env.UDID || 'Pixel_XL_API_30',
+            'newCommandTimeout': 300000,
+            'androidDeviceReadyTimeout': 300000,
+            'androidInstallTimeout': 90000,
+            'appWaitDuration': 300000,
+            'autoGrantPermissions': true,
+            'gpsEnabled': true,
+            'isHeadless': false,
+            'noReset': false,
+            'noSign': true,
+        }
+...
+```
+
+
+Demo project to try with Appium v2: https://github.com/kobenguyent/thanh-nguyen/tree/main/task2

package/lib/codecept.js

@@ -176,6 +176,7 @@ class Codecept {
    * Run a specific test or all loaded tests.
    *
    * @param {string} [test]
+   * @returns {Promise<void>}
    */
   async run(test) {
     return new Promise((resolve, reject) => {

package/lib/command/definitions.js

@@ -17,7 +17,6 @@ const actingHelpers = [...require('../plugin/standardActingHelpers'), 'REST'];
  * @param {Map} params.supportObject
  * @param {Array<string>} params.helperNames
  * @param {Array<string>} params.importPaths
- * @param {Array<string>} params.customHelpers
  * @param params.translations
  *
  * @returns {string}
@@ -29,15 +28,13 @@ const getDefinitionsFileContent = ({
   supportObject,
   importPaths,
   translations,
-  customHelpers,
 }) => {
   const getHelperListFragment = ({
     hasCustomHelper,
     hasCustomStepsFile,
-    customHelpers,
   }) => {
     if (hasCustomHelper && hasCustomStepsFile) {
-      return `${['ReturnType<steps_file>', ...customHelpers].join(', ')}`;
+      return `${['ReturnType<steps_file>', 'WithTranslation<Methods>'].join(', ')}`;
     }
 
     if (hasCustomStepsFile) {
@@ -50,7 +47,6 @@ const getDefinitionsFileContent = ({
   const helpersListFragment = getHelperListFragment({
     hasCustomHelper,
     hasCustomStepsFile,
-    customHelpers,
   });
 
   const importPathsFragment = importPaths.join('\n');
@@ -143,7 +139,7 @@ module.exports = function (genPath, options) {
     }
 
     if (!actingHelpers.includes(name)) {
-      customHelpers.push(`WithTranslation<${name}>`);
+      customHelpers.push(name);
     }
   }
 
@@ -186,7 +182,6 @@ module.exports = function (genPath, options) {
     translations,
     hasCustomStepsFile,
     hasCustomHelper,
-    customHelpers,
   });
 
   // add aliases for translations

package/lib/command/init.js

@@ -201,7 +201,13 @@ module.exports = function (initPath) {
       // no extra step file for typescript (as it doesn't match TS conventions)
       const stepFile = `./steps_file.${extension}`;
       fs.writeFileSync(path.join(testsPath, stepFile), extension === 'ts' ? defaultActorTs : defaultActor);
-      config.include.I = isTypeScript === true ? './steps_file' : stepFile;
+
+      if (isTypeScript) {
+        config.include = _actorTranslation('./steps_file', config.translation);
+      } else {
+        config.include = _actorTranslation(stepFile, config.translation);
+      }
+
       print(`Steps file created at ${stepFile}`);
 
       let configSource;
@@ -316,7 +322,7 @@ module.exports = function (initPath) {
     };
 
     print('Configure helpers...');
-    inquirer.prompt(helperConfigs).then((helperResult) => {
+    inquirer.prompt(helperConfigs).then(async (helperResult) => {
       if (helperResult.Playwright_browser === 'electron') {
         delete helperResult.Playwright_url;
         delete helperResult.Playwright_show;
@@ -336,12 +342,12 @@ module.exports = function (initPath) {
       });
 
       print('');
-      finish();
+      await finish();
     });
   });
 };
 
-function install(dependencies, verbose) {
+function install(dependencies) {
   let command;
   let args;
 
@@ -374,9 +380,39 @@ function install(dependencies, verbose) {
     ].concat(dependencies);
   }
 
+  if (process.env._INIT_DRY_RUN_INSTALL) {
+    args.push('--dry-run');
+  }
+
   const { status } = spawn.sync(command, args, { stdio: 'inherit' });
   if (status !== 0) {
     throw new Error(`${command} ${args.join(' ')} failed`);
   }
   return true;
 }
+
+function _actorTranslation(stepFile, translationSelected) {
+  let actor;
+
+  for (const translationAvailable of translations) {
+    if (actor) {
+      break;
+    }
+
+    if (translationSelected === translationAvailable) {
+      const nameOfActor = require('../../translations')[translationAvailable].I;
+
+      actor = {
+        [nameOfActor]: stepFile,
+      };
+    }
+  }
+
+  if (!actor) {
+    actor = {
+      I: stepFile,
+    };
+  }
+
+  return actor;
+}

package/lib/command/run-multiple/collection.js

@@ -47,14 +47,26 @@ class Collection {
    */
   prepareRuns(selectedRuns, config) {
     selectedRuns.forEach((selectedRun) => {
-      const [runName] = selectedRun.split(':');
-      const runConfig = config.multiple[runName];
+      const runConfig = [];
+      const runName = [];
 
-      if (!runConfig) {
-        throw new Error(`run ${runName} was not configured in "multiple" section of config`);
+      if (selectedRun === 'all') {
+        Object.keys(config.multiple).forEach(name => {
+          runName.push(name);
+          runConfig.push(config.multiple[name]);
+        });
+      } else {
+        runName.push(selectedRun.split(':')[0]);
+        runConfig.push(config.multiple[runName[0]]);
       }
 
-      this.addRun(createRun(runName, runConfig));
+      for (let i = 0; i < runConfig.length; i++) {
+        if (!runConfig[i]) {
+          throw new Error(`run ${runName[i]} was not configured in "multiple" section of config`);
+        }
+
+        this.addRun(createRun(runName[i], runConfig[i]));
+      }
     });
 
     return this;

package/lib/command/run-workers.js

@@ -39,6 +39,10 @@ module.exports = async function (workerCount, selectedRuns, options) {
   });
 
   try {
+    if (options.verbose) {
+      const getInfo = require('./info');
+      await getInfo();
+    }
     await workers.bootstrapAll();
     await workers.run();
   } catch (err) {

package/lib/command/run.js

@@ -28,6 +28,12 @@ module.exports = async function (test, options) {
     codecept.init(testRoot);
     await codecept.bootstrap();
     codecept.loadTests(test);
+
+    if (options.verbose) {
+      const getInfo = require('./info');
+      await getInfo();
+    }
+
     await codecept.run();
   } catch (err) {
     printError(err);

package/lib/helper/Appium.js

@@ -117,6 +117,43 @@ const vendorPrefix = {
  * }
  * ```
  *
+ * Example Android App using Appiumv2 on BrowserStack:
+ *
+ * ```js
+ * {
+ * helpers: {
+ *   Appium: {
+ *         appiumV2: true,
+ *         host: "hub-cloud.browserstack.com",
+ *         port: 4444,
+ *         user: process.env.BROWSERSTACK_USER,
+ *         key: process.env.BROWSERSTACK_KEY,
+ *         app: `bs://c700ce60cf1gjhgjh3ae8ed9770ghjg5a55b8e022f13c5827cg`,
+ *         browser: '',
+ *         desiredCapabilities: {
+ *             'appPackage': data.packageName,
+ *             'deviceName': process.env.DEVICE || 'Google Pixel 3',
+ *             'platformName': process.env.PLATFORM || 'android',
+ *             'platformVersion': process.env.OS_VERSION || '10.0',
+ *             'automationName': process.env.ENGINE || 'UIAutomator2',
+ *             'newCommandTimeout': 300000,
+ *             'androidDeviceReadyTimeout': 300000,
+ *             'androidInstallTimeout': 90000,
+ *             'appWaitDuration': 300000,
+ *             'autoGrantPermissions': true,
+ *             'gpsEnabled': true,
+ *             'isHeadless': false,
+ *             'noReset': false,
+ *             'noSign': true,
+ *             'bstack:options' : {
+ *                 "appiumVersion" : "2.0.1",
+ *             },
+ *         }
+ *   }
+ * }
+ * }
+ * ```
+ *
  * Additional configuration params can be used from <https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md>
  *
  * ## Access From Helpers
@@ -234,7 +271,9 @@ class Appium extends Webdriver {
     const _convertedCaps = {};
     for (const [key, value] of Object.entries(capabilities)) {
       if (!key.startsWith(vendorPrefix.appium)) {
-        _convertedCaps[`${vendorPrefix.appium}:${key}`] = value;
+        if (key !== 'platformName') {
+          _convertedCaps[`${vendorPrefix.appium}:${key}`] = value;
+        }
       } else {
         _convertedCaps[`${key}`] = value;
       }
@@ -1433,8 +1472,9 @@ class Appium extends Webdriver {
    *
    */
   async dontSeeInField(field, value) {
-    if (this.isWeb) return super.dontSeeInField(field, value);
-    return super.dontSeeInField(parseLocator.call(this, field), value);
+    const _value = (typeof value === 'boolean') ? value : value.toString();
+    if (this.isWeb) return super.dontSeeInField(field, _value);
+    return super.dontSeeInField(parseLocator.call(this, field), _value);
   }
 
   /**
@@ -1565,8 +1605,9 @@ class Appium extends Webdriver {
    *
    */
   async seeInField(field, value) {
-    if (this.isWeb) return super.seeInField(field, value);
-    return super.seeInField(parseLocator.call(this, field), value);
+    const _value = (typeof value === 'boolean') ? value : value.toString();
+    if (this.isWeb) return super.seeInField(field, _value);
+    return super.seeInField(parseLocator.call(this, field), _value);
   }
 
   /**

package/lib/helper/GraphQL.js

@@ -81,6 +81,8 @@ class GraphQL extends Helper {
       'Content-Type': 'application/json',
     });
 
+    request.headers = { ...this.headers, ...request.headers };
+
     if (this.config.onRequest) {
       await this.config.onRequest(request);
     }
@@ -200,5 +202,28 @@ class GraphQL extends Helper {
   _setRequestTimeout(newTimeout) {
     this.options.timeout = newTimeout;
   }
+
+  /**
+   * Sets request headers for all requests of this test
+   *
+   * @param {object} headers headers list
+   */
+  haveRequestHeaders(headers) {
+    this.headers = { ...this.headers, ...headers };
+  }
+
+  /**
+   * Adds a header for Bearer authentication
+   *
+   * ```js
+   * // we use secret function to hide token from logs
+   * I.amBearerAuthenticated(secret('heregoestoken'))
+   * ```
+   *
+   * @param {string | CodeceptJS.Secret} accessToken  Bearer access token
+   */
+  amBearerAuthenticated(accessToken) {
+    this.haveRequestHeaders({ Authorization: `Bearer ${accessToken}` });
+  }
 }
 module.exports = GraphQL;