codeceptjs 3.0.7 → 3.1.3

package/lib/plugin/{puppeteerCoverage.js → coverage.js}

@@ -1,4 +1,4 @@
-const debug = require('debug')('codeceptjs:plugin:puppeteerCoverage');
+const debugModule = require('debug');
 const fs = require('fs');
 const path = require('path');
 
@@ -13,7 +13,7 @@ const defaultConfig = {
   uniqueFileName: true,
 };
 
-const supportedHelpers = ['Puppeteer'];
+const supportedHelpers = ['Puppeteer', 'Playwright'];
 
 function buildFileName(test, uniqueFileName) {
   let fileName = clearString(test.title);
@@ -41,15 +41,14 @@ function buildFileName(test, uniqueFileName) {
 }
 
 /**
- * Dumps puppeteers code coverage after every test.
+ * Dumps code coverage from Playwright/Puppeteer after every test.
  *
  * #### Configuration
  *
- * Configuration can either be taken from a corresponding helper (deprecated) or a from plugin config (recommended).
  *
  * ```js
  * plugins: {
- *    puppeteerCoverage: {
+ *    coverage: {
  *      enabled: true
  *    }
  * }
@@ -59,33 +58,22 @@ function buildFileName(test, uniqueFileName) {
  *
  * * `coverageDir`: directory to dump coverage files
  * * `uniqueFileName`: generate a unique filename by adding uuid
- *
- *  First of all, your mileage may vary!
- *
- *  To work, you need the client javascript code to be NOT uglified. They need to be built in "development" mode.
- *  And the end of your tests, you'll get a directory full of coverage per test run.  Now what?
- *  You'll need to convert the coverage code to something istanbul can read.  Good news is someone wrote the code
- *  for you (see puppeteer-to-istanbul link below).  Then using istanbul you need to combine the converted
- *  coverage and create a report.  Good luck!
- *
- *  Links:
- *  * https://github.com/GoogleChrome/puppeteer/blob/v1.12.2/docs/api.md#class-coverage
- *  * https://github.com/istanbuljs/puppeteer-to-istanbul
- *  * https://github.com/gotwarlost/istanbul
  */
 module.exports = function (config) {
   const helpers = Container.helpers();
   let coverageRunning = false;
   let helper;
 
+  let debug;
   for (const helperName of supportedHelpers) {
     if (Object.keys(helpers).indexOf(helperName) > -1) {
       helper = helpers[helperName];
+      debug = debugModule(`codeceptjs:plugin:${helperName.toLowerCase()}Coverage`);
     }
   }
 
   if (!helper) {
-    console.error('Coverage is only supported in Puppeteer');
+    console.error('Coverage is only supported in Puppeteer, Playwright');
     return; // no helpers for screenshot
   }
 
@@ -102,7 +90,7 @@ module.exports = function (config) {
       'starting coverage',
       async () => {
         try {
-          if (!coverageRunning) {
+          if (!coverageRunning && helper.page && helper.page.coverage) {
             debug('--> starting coverage <--');
             coverageRunning = true;
             await helper.page.coverage.startJSCoverage();
@@ -115,13 +103,13 @@ module.exports = function (config) {
     );
   });
 
-  // Save puppeteer coverage data after every test run
+  // Save coverage data after every test run
   event.dispatcher.on(event.test.after, async (test) => {
     recorder.add(
       'saving coverage',
       async () => {
         try {
-          if (coverageRunning) {
+          if (coverageRunning && helper.page && helper.page.coverage) {
             debug('--> stopping coverage <--');
             coverageRunning = false;
             const coverage = await helper.page.coverage.stopJSCoverage();

package/lib/plugin/customLocator.js

@@ -38,7 +38,7 @@ const defaultConfig = {
  * // in codecept.conf.js
  * plugins: {
  *  customLocator: {
- *    enabled: true
+ *    enabled: true,
  *    attribute: 'data-test'
  *  }
  * }
@@ -57,7 +57,7 @@ const defaultConfig = {
  * // in codecept.conf.js
  * plugins: {
  *  customLocator: {
- *    enabled: true
+ *    enabled: true,
  *    prefix: '=',
  *    attribute: 'data-qa'
  *  }

package/lib/plugin/subtitles.js

@@ -0,0 +1,88 @@
+const { v4: uuidv4 } = require('uuid');
+const fsPromise = require('fs').promises;
+const path = require('path');
+const event = require('../event');
+
+// This will convert a given timestamp in milliseconds to
+// an SRT recognized timestamp, ie HH:mm:ss,SSS
+function formatTimestamp(timestampInMs) {
+  const date = new Date(0, 0, 0, 0, 0, 0, timestampInMs);
+  const hours = date.getHours();
+  const minutes = date.getMinutes();
+  const seconds = date.getSeconds();
+  const ms = timestampInMs - (hours * 3600000 + minutes * 60000 + seconds * 1000);
+  return `${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')},${ms.toString().padStart(3, '0')}`;
+}
+
+let steps = {};
+let testStartedAt;
+/**
+ * Automatically captures steps as subtitle, and saves it as an artifact when a video is found for a failed test
+ *
+ * #### Configuration
+ * ```js
+ * plugins: {
+ *  subtitles: {
+ *    enabled: true
+ *  }
+ * }
+ * ```
+ */
+module.exports = function () {
+  event.dispatcher.on(event.test.before, (_) => {
+    testStartedAt = Date.now();
+    steps = {};
+  });
+
+  event.dispatcher.on(event.step.started, (step) => {
+    const stepStartedAt = Date.now();
+    step.id = uuidv4();
+
+    let title = `${step.actor}.${step.name}(${step.args ? step.args.join(',') : ''})`;
+    if (title.length > 100) {
+      title = `${title.substring(0, 100)}...`;
+    }
+
+    steps[step.id] = {
+      start: formatTimestamp(stepStartedAt - testStartedAt),
+      startedAt: stepStartedAt,
+      title,
+    };
+  });
+
+  event.dispatcher.on(event.step.finished, (step) => {
+    if (step && step.id && steps[step.id]) {
+      steps[step.id].end = formatTimestamp(Date.now() - testStartedAt);
+    }
+  });
+
+  event.dispatcher.on(event.test.after, async (test) => {
+    if (test && test.artifacts && test.artifacts.video) {
+      const stepsSortedByStartTime = Object.values(steps);
+      stepsSortedByStartTime.sort((stepA, stepB) => {
+        return stepA.startedAt - stepB.startedAt;
+      });
+
+      let subtitle = '';
+
+      // For an SRT file, every subtitle has to be in the format as mentioned below:
+      //
+      // 1
+      // HH:mm:ss,SSS --> HH:mm:ss,SSS
+      // [title]
+      stepsSortedByStartTime.forEach((step, index) => {
+        if (step.end) {
+          subtitle = `${subtitle}${index + 1}
+${step.start} --> ${step.end}
+${step.title}
+
+`;
+        }
+      });
+
+      const { dir: artifactsDirectory, name: fileName } = path.parse(test.artifacts.video);
+      await fsPromise.writeFile(`${artifactsDirectory}/${fileName}.srt`, subtitle);
+      test.artifacts.subtitle = `${artifactsDirectory}/${fileName}.srt`;
+    }
+  });
+};

package/lib/plugin/tryTo.js

@@ -89,7 +89,7 @@ function tryTo(callback) {
     recorder.session.catch((err) => {
       result = false;
       const msg = err.inspect ? err.inspect() : err.toString();
-      debug(`Unsuccesful try > ${msg}`);
+      debug(`Unsuccessful try > ${msg}`);
       recorder.session.restore('tryTo');
       return result;
     });

package/lib/recorder.js

@@ -3,6 +3,8 @@ const promiseRetry = require('promise-retry');
 
 const { log } = require('./output');
 
+const MAX_TASKS = 100;
+
 let promise;
 let running = false;
 let errFn;
@@ -172,7 +174,7 @@ module.exports = {
       return;
     }
     tasks.push(taskName);
-    debug(`${currentQueue()}Queued | ${taskName}`);
+    if (process.env.DEBUG) debug(`${currentQueue()}Queued | ${taskName}`);
 
     return promise = Promise.resolve(promise).then((res) => {
       const retryOpts = this.retries.slice(-1).pop();
@@ -296,7 +298,7 @@ module.exports = {
    * @inner
    */
   stop() {
-    debug(this.toString());
+    if (process.env.DEBUG) debug(this.toString());
     log(`${currentQueue()}Stopping recording promises`);
     running = false;
   },
@@ -318,7 +320,7 @@ module.exports = {
    * @inner
    */
   scheduled() {
-    return tasks.join('\n');
+    return tasks.slice(-MAX_TASKS).join('\n');
   },
 
   /**

package/lib/step.js

@@ -212,16 +212,18 @@ class MetaStep extends Step {
       step.metaStep = this;
     };
     event.dispatcher.prependListener(event.step.before, registerStep);
+    let rethrownError = null;
     try {
       this.startTime = Date.now();
       result = fn.apply(this.context, this.args);
     } catch (error) {
-      this.status = 'failed';
+      this.setStatus('failed');
+      rethrownError = error;
     } finally {
       this.endTime = Date.now();
-
       event.dispatcher.removeListener(event.step.before, registerStep);
     }
+    if (rethrownError) { throw rethrownError; }
     return result;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "3.0.7",
+  "version": "3.1.3",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [
     "acceptance",
@@ -84,7 +84,8 @@
     "promise-retry": "^1.1.1",
     "requireg": "^0.2.2",
     "resq": "^1.10.0",
-    "sprintf-js": "^1.1.1"
+    "sprintf-js": "^1.1.1",
+    "uuid": "^8.3.2"
   },
   "devDependencies": {
     "@codeceptjs/detox-helper": "^1.0.2",
@@ -122,7 +123,7 @@
     "nodemon": "^1.19.4",
     "playwright": "^1.9.1",
     "protractor": "^5.4.4",
-    "puppeteer": "^8.0.0",
+    "puppeteer": "^10.0.0",
     "qrcode-terminal": "^0.12.0",
     "rosie": "^1.6.0",
     "runok": "^0.9.2",

package/typings/index.d.ts

@@ -111,6 +111,7 @@ declare const pause: typeof CodeceptJS.pause;
 declare const within: typeof CodeceptJS.within;
 declare const session: typeof CodeceptJS.session;
 declare const DataTable: typeof CodeceptJS.DataTable;
+declare const DataTableArgument: typeof CodeceptJS.DataTableArgument;
 declare const codeceptjs: typeof CodeceptJS.index;
 declare const locate: typeof CodeceptJS.Locator.build;
 declare function inject(): CodeceptJS.SupportObject;
@@ -160,6 +161,7 @@ declare namespace NodeJS {
     within: typeof within;
     session: typeof session;
     DataTable: typeof DataTable;
+    DataTableArgument: typeof DataTableArgument;
     locate: typeof locate;
     inject: typeof inject;
     secret: typeof secret;

package/typings/types.d.ts

@@ -321,11 +321,11 @@ declare namespace CodeceptJS {
          * ```js
          * I.removeApp('appName', 'com.example.android.apis');
          * ```
-         * @param bundleId - String  ID of bundle
          *
          * Appium: support only Android
+         * @param [bundleId] - ID of bundle
          */
-        removeApp(appId: string, bundleId: string): void;
+        removeApp(appId: string, bundleId?: string): void;
         /**
          * Check current activity on an Android device.
          *
@@ -522,11 +522,12 @@ declare namespace CodeceptJS {
          * // or by pressing key
          * I.hideDeviceKeyboard('pressKey', 'Done');
          * ```
-         * @param strategy - desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)
          *
          * Appium: support Android and iOS
+         * @param [strategy] - Desired strategy to close keyboard (‘tapOutside’ or ‘pressKey’)
+         * @param [key] - Optional key
          */
-        hideDeviceKeyboard(strategy: 'tapOutside' | 'pressKey'): void;
+        hideDeviceKeyboard(strategy?: 'tapOutside' | 'pressKey', key?: string): void;
         /**
          * Send a key event to the device.
          * List of keys: https://developer.android.com/reference/android/view/KeyEvent.html
@@ -682,8 +683,9 @@ declare namespace CodeceptJS {
          * ```
          *
          * Appium: support Android and iOS
+         * @param actions - Array of touch actions
          */
-        touchPerform(): void;
+        touchPerform(actions: any[]): void;
         /**
          * Pulls a file from the device.
          *
@@ -886,6 +888,45 @@ declare namespace CodeceptJS {
          * @returns attribute value
          */
         grabTextFrom(locator: CodeceptJS.LocatorOrString): Promise<string>;
+        /**
+         * Grab number of visible elements by locator.
+         * Resumes test execution, so **should be used inside async function with `await`** operator.
+         *
+         * ```js
+         * let numOfElements = await I.grabNumberOfVisibleElements('p');
+         * ```
+         * @param locator - located by CSS|XPath|strict locator.
+         * @returns number of visible elements
+         */
+        grabNumberOfVisibleElements(locator: CodeceptJS.LocatorOrString): Promise<number>;
+        /**
+         * Can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
+         *
+         * Retrieves an attribute from an element located by CSS or XPath and returns it to test.
+         * Resumes test execution, so **should be used inside async with `await`** operator.
+         * If more than one element is found - attribute of first element is returned.
+         *
+         * ```js
+         * let hint = await I.grabAttributeFrom('#tooltip', 'title');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @param attr - attribute name.
+         * @returns attribute value
+         */
+        grabAttributeFrom(locator: CodeceptJS.LocatorOrString, attr: string): Promise<string>;
+        /**
+         * Can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
+         * Retrieves an array of attributes from elements located by CSS or XPath and returns it to test.
+         * Resumes test execution, so **should be used inside async with `await`** operator.
+         *
+         * ```js
+         * let hints = await I.grabAttributeFromAll('.tooltip', 'title');
+         * ```
+         * @param locator - element located by CSS|XPath|strict locator.
+         * @param attr - attribute name.
+         * @returns attribute value
+         */
+        grabAttributeFromAll(locator: CodeceptJS.LocatorOrString, attr: string): Promise<string[]>;
         /**
          * Retrieves an array of value from a form located by CSS or XPath and returns it to test.
          * Resumes test execution, so **should be used inside async function with `await`** operator.
@@ -909,6 +950,16 @@ declare namespace CodeceptJS {
          * @returns attribute value
          */
         grabValueFrom(locator: CodeceptJS.LocatorOrString): Promise<string>;
+        /**
+         * Saves a screenshot to ouput folder (set in codecept.json or codecept.conf.js).
+         * Filename is relative to output folder.
+         *
+         * ```js
+         * I.saveScreenshot('debug.png');
+         * ```
+         * @param fileName - file name to save.
+         */
+        saveScreenshot(fileName: string): void;
         /**
          * Scroll element into viewport.
          *
@@ -2368,6 +2419,8 @@ declare namespace CodeceptJS {
      * * `restart`: (optional, default: true) - restart browser between tests.
      * * `disableScreenshots`: (optional, default: false)  - don't save screenshot on failure.
      * * `emulate`: (optional, default: {}) launch browser in device emulation mode.
+     * * `video`: (optional, default: false) enables video recording for failed tests; videos are saved into `output/videos` folder
+     * * `trace`: (optional, default: false) record [tracing information](https://playwright.dev/docs/trace-viewer) with screenshots and snapshots.
      * * `fullPageScreenshots` (optional, default: false) - make full page screenshots on failure.
      * * `uniqueScreenshotNames`: (optional, default: false)  - option to prevent screenshot override if you have scenarios with the same name in different suites.
      * * `keepBrowserState`: (optional, default: false) - keep browser state between tests when `restart` is set to false.
@@ -2384,6 +2437,22 @@ declare namespace CodeceptJS {
      * * `chromium`: (optional) pass additional chromium options
      * * `electron`: (optional) pass additional electron options
      *
+     * #### Video Recording Customization
+     *
+     * By default, video is saved to `output/video` dir. You can customize this path by passing `dir` option to `recordVideo` option.
+     *
+     * * `video`: enables video recording for failed tests; videos are saved into `output/videos` folder
+     * * `keepVideoForPassedTests`: - save videos for passed tests
+     * * `recordVideo`: [additional options for videos customization](https://playwright.dev/docs/next/api/class-browser#browser-new-context)
+     *
+     * #### Trace Recording Customization
+     *
+     * Trace recording provides a complete information on test execution and includes DOM snapshots, 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
@@ -2435,7 +2504,7 @@ declare namespace CodeceptJS {
      *      Playwright: {
      *        url: "http://localhost",
      *        chromium: {
-     *          browserWSEndpoint: { wsEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a' }
+     *          browserWSEndpoint: 'ws://localhost:9222/devtools/browser/c5aa6160-b5bc-4d53-bb49-6ecb36cd2e0a'
      *        }
      *      }
      *    }
@@ -3902,6 +3971,29 @@ declare namespace CodeceptJS {
          * @returns Element bounding rectangle
          */
         grabElementBoundingRect(locator: LocatorOrString, elementSize?: string): Promise<DOMRect> | Promise<number>;
+        /**
+         * Mocks network request using [`browserContext.route`](https://playwright.dev/docs/api/class-browsercontext#browser-context-route) of Playwright
+         *
+         * ```js
+         * I.mockRoute(/(\.png$)|(\.jpg$)/, route => route.abort());
+         * ```
+         * This method allows intercepting and mocking requests & responses. [Learn more about it](https://playwright.dev/docs/network#handle-requests)
+         * @param [url] - URL, regex or pattern for to match URL
+         * @param [handler] - a function to process request
+         */
+        mockRoute(url?: string, handler?: (...params: any[]) => any): void;
+        /**
+         * Stops network mocking created by `mockRoute`.
+         *
+         * ```js
+         * I.stopMockingRoute(/(\.png$)|(\.jpg$)/);
+         * I.stopMockingRoute(/(\.png$)|(\.jpg$)/, previouslySetHandler);
+         * ```
+         * If no handler is passed, all mock requests for the rote are disabled.
+         * @param [url] - URL, regex or pattern for to match URL
+         * @param [handler] - a function to process request
+         */
+        stopMockingRoute(url?: string, handler?: (...params: any[]) => any): void;
     }
     /**
      * This helper works the same as MockRequest helper. It has been included for backwards compatibility
@@ -5294,6 +5386,7 @@ declare namespace CodeceptJS {
      *    }
      * }
      * ```
+     * > Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
      *
      * #### Example #5: Target URL with provided basic authentication
      *
@@ -5308,10 +5401,25 @@ declare namespace CodeceptJS {
      *    }
      * }
      * ```
+     * #### Troubleshooting
      *
+     * Error Message:  `No usable sandbox!`
+     *
+     * When running Puppeteer on CI try to disable sandbox if you see that message
+     *
+     * ```
+     * helpers: {
+     *  Puppeteer: {
+     *     url: 'http://localhost',
+     *     show: false,
+     *     chrome: {
+     *       args: ['--no-sandbox', '--disable-setuid-sandbox']
+     *     }
+     *   },
+     * }
+     * ```
      *
      *
-     * Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
      *
      * ## Access From Helpers
      *
@@ -6850,8 +6958,9 @@ declare namespace CodeceptJS {
     class REST {
         /**
          * Executes axios request
+         * @returns response
          */
-        _executeRequest(request: any): void;
+        _executeRequest(request: any): Promise<any>;
         /**
          * Generates url based on format sent (takes endpoint + url if latter lacks 'http')
          */
@@ -6871,8 +6980,9 @@ declare namespace CodeceptJS {
          * I.sendGetRequest('/api/users.json');
          * ```
          * @param [headers = {}] - the headers object to be sent. By default it is sent as an empty object
+         * @returns response
          */
-        sendGetRequest(url: any, headers?: any): void;
+        sendGetRequest(url: any, headers?: any): Promise<any>;
         /**
          * Sends POST request to API.
          *
@@ -6885,8 +6995,9 @@ declare namespace CodeceptJS {
          * ```
          * @param [payload = {}] - the payload to be sent. By default it is sent as an empty object
          * @param [headers = {}] - the headers object to be sent. By default it is sent as an empty object
+         * @returns response
          */
-        sendPostRequest(url: any, payload?: any, headers?: any): void;
+        sendPostRequest(url: any, payload?: any, headers?: any): Promise<any>;
         /**
          * Sends PATCH request to API.
          *
@@ -6899,8 +7010,9 @@ declare namespace CodeceptJS {
          * ```
          * @param [payload = {}] - the payload to be sent. By default it is sent as an empty object
          * @param [headers = {}] - the headers object to be sent. By default it is sent as an empty object
+         * @returns response
          */
-        sendPatchRequest(url: string, payload?: any, headers?: any): void;
+        sendPatchRequest(url: string, payload?: any, headers?: any): Promise<any>;
         /**
          * Sends PUT request to API.
          *
@@ -6913,8 +7025,9 @@ declare namespace CodeceptJS {
          * ```
          * @param [payload = {}] - the payload to be sent. By default it is sent as an empty object
          * @param [headers = {}] - the headers object to be sent. By default it is sent as an empty object
+         * @returns response
          */
-        sendPutRequest(url: string, payload?: any, headers?: any): void;
+        sendPutRequest(url: string, payload?: any, headers?: any): Promise<any>;
         /**
          * Sends DELETE request to API.
          *
@@ -6922,8 +7035,9 @@ declare namespace CodeceptJS {
          * I.sendDeleteRequest('/api/users/1');
          * ```
          * @param [headers = {}] - the headers object to be sent. By default it is sent as an empty object
+         * @returns response
          */
-        sendDeleteRequest(url: any, headers?: any): void;
+        sendDeleteRequest(url: any, headers?: any): Promise<any>;
     }
     /**
      * SeleniumWebdriver helper is based on the official [Selenium Webdriver JS](https://www.npmjs.com/package/selenium-webdriver)
@@ -8656,8 +8770,6 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param attr - attribute name.
          * @returns attribute value
-         *
-         * Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
          */
         grabAttributeFromAll(locator: CodeceptJS.LocatorOrString, attr: string): Promise<string[]>;
         /**
@@ -8671,8 +8783,6 @@ declare namespace CodeceptJS {
          * @param locator - element located by CSS|XPath|strict locator.
          * @param attr - attribute name.
          * @returns attribute value
-         *
-         * Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
          */
         grabAttributeFrom(locator: CodeceptJS.LocatorOrString, attr: string): Promise<string>;
         /**
@@ -9695,7 +9805,7 @@ declare namespace CodeceptJS {
          * add print comment method`
          */
         say(msg: string, color?: string): Promise<any> | undefined;
-        retry(opts: any): this;
+        retry(opts?: any): this;
     }
     /**
      * Create CodeceptJS runner.
@@ -9839,6 +9949,34 @@ declare namespace CodeceptJS {
         xadd(array: any[]): void;
         filter(func: (...params: any[]) => any): void;
     }
+    /**
+     * DataTableArgument class to store the Cucumber data table from
+     * a step as an object with methods that can be used to access the data.
+     */
+    class DataTableArgument {
+        constructor(gherkinDataTable: any);
+        /**
+         * Returns the table as a 2-D array
+         */
+        raw(): string[][];
+        /**
+         * Returns the table as a 2-D array, without the first row
+         */
+        rows(): string[][];
+        /**
+         * Returns an array of objects where each row is converted to an object (column header is the key)
+         */
+        hashes(): any[];
+        /**
+         * Returns an object where each row corresponds to an entry
+         * (first column is the key, second column is the value)
+         */
+        rowsHash(): Record<string, string>;
+        /**
+         * Transposed the data
+         */
+        transpose(): void;
+    }
     namespace event {
         const dispatcher: NodeJS.EventEmitter;
         const test: {
@@ -9935,6 +10073,7 @@ declare namespace CodeceptJS {
         var pause: typeof CodeceptJS.pause;
         var within: typeof CodeceptJS.within;
         var dataTable: typeof CodeceptJS.DataTable;
+        var dataTableArgument: typeof CodeceptJS.DataTableArgument;
         var store: typeof CodeceptJS.store;
         var locator: typeof CodeceptJS.Locator;
     }
@@ -10020,6 +10159,7 @@ declare namespace CodeceptJS {
         isCustom(): boolean;
         isStrict(): boolean;
         isAccessibilityId(): boolean;
+        isBasic(): boolean;
         toXPath(): string;
         or(locator: CodeceptJS.LocatorOrString): Locator;
         find(locator: CodeceptJS.LocatorOrString): Locator;