testcafe 2.2.0-rc.2 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## v2.2.0 (2022-12-29)
+
+TestCafe v2.2.0 introduces user-defined custom actions and an important *experimental* capability. Google Chrome users can now enable "proxyless mode" to speed up their test suite.
+
+### Custom Action Support
+
+TestCafe users can now define [custom test actions](xref:404150). Place the definition function in a [**JavaScript** configuration file](xref:402638#customactions):
+
+```js
+module.exports = {
+  customActions: {
+   async makeCoffee (args) {
+        await this.click(args);
+    }, 
+  }
+};
+```
+
+Include custom methods in your tests alongside [other TestController methods](xref:402632#test-controller-api). 
+Add the `customActions` prefix when you call the action:
+
+```js
+test('Test with a custom action', async t => {
+    await t.click()
+        .customActions.makeCoffee()
+        .click();
+})
+```
+
+### Experimental: Proxyless mode
+
+TestCafe runs an under-the-hood [reverse proxy](xref:402631#page-proxying) to automate tests across different browsers. But this technique complicates the framework. Native automation protocols offer superior automation speeds and greater stability. That's why the TestCafe team decided to gradually phase the reverse proxy out in favor of native support for these automation protocols.
+
+TestCafe v2.2.0 includes an **experimental** option that disables the proxy for **Google Chrome**. 
+
+```sh
+testcafe chrome tests --experimental-proxyless
+```
+
+You can enable this option in the [command line interface](xref:402639#--experimental-proxyless), the [Test Runner API](xref:402662), and the [configuration file](xref:402638#experimentalproxyless). Read the [Proxyless mode guide](xref:404237) for more information.
+
+### Bug Fixes
+
+* TestCafe doesn't hide the live mode status bar when the bar obstructs the action target ([#7384](https://github.com/DevExpress/testcafe/issues/7384))
+* The 'Target element is overlapped' message does not reference the Selector that caused the warning ([#7386](https://github.com/DevExpress/testcafe/issues/7386))
+* The TestCafe Dashboard reporter includes an outdated `uuid` dependency ([testcafe-reporter-dashboard#111](https://github.com/DevExpress/testcafe-reporter-dashboard/issues/111))
+* TestCafe doesn't display the correct error message when the framework throws an exception ([#6936](https://github.com/DevExpress/testcafe/issues/6936))
+* TestCafe retains some cookies after the user requests their deletion (PR [testcafe-hammerhead#2818](https://github.com/DevExpress/testcafe-hammerhead/pull/2818))
+* TestCafe cannot load test pages with the `localhost` URL on Node.js v17 and up ([#7396](https://github.com/DevExpress/testcafe/issues/7396))
+* TestCafe cannot take screenshots in headless Chrome on Node.js v17 and up ([#7408](https://github.com/DevExpress/testcafe/issues/7408))
+* Web workers that originate from Blob URLs throw an error when they call the  `importScript` function ([#7378](https://github.com/DevExpress/testcafe/issues/7378))
+* TestCafe doesn't set the correct `Request` header when an `iframe` points the user to a new URL ([#7376](https://github.com/DevExpress/testcafe/issues/7376), PR [testcafe-hammerhead#2813](https://github.com/DevExpress/testcafe-hammerhead/pull/2813) by [@naggingant](https://github.com/naggingant))
+* TestCafe cannot interact with options that belong to a `<select>` element with the `multiple` attribute (PR [testcafe-hammerhead#2815](https://github.com/DevExpress/testcafe-hammerhead/pull/2815))
+
 ## v2.1.0 (2022-11-10)
 
 ### Improvements

package/lib/configuration/types.js

@@ -1,3 +1,3 @@
 "use strict";
 const RequestHook = require('../api/request-hooks/hook');
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlndXJhdGlvbi90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJjb25zdCBSZXF1ZXN0SG9vayA9IHJlcXVpcmUoJy4uL2FwaS9yZXF1ZXN0LWhvb2tzL2hvb2snKTtcblxuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFyc1xudHlwZSBUZW1wbGF0ZUFyZ3VtZW50cyA9IGFueVtdO1xuXG5pbnRlcmZhY2UgU2NyZWVuc2hvdE9wdGlvblZhbHVlIHtcbiAgICBwYXRoOiBzdHJpbmc7XG4gICAgdGFrZU9uRmFpbHM/OiBib29sZWFuO1xuICAgIHBhdGhQYXR0ZXJuPzogc3RyaW5nO1xuICAgIGZ1bGxQYWdlPzogYm9vbGVhbjtcbiAgICB0aHVtYm5haWxzPzogYm9vbGVhbjtcbiAgICBhdXRvVGFrZU9uRmFpbHM/OiBib29sZWFuO1xufVxuXG5pbnRlcmZhY2UgUXVhcmFudGluZU9wdGlvblZhbHVlIHtcbiAgICBhdHRlbXB0TGltaXQ/OiBudW1iZXI7XG4gICAgc3VjY2Vzc1RocmVzaG9sZD86IG51bWJlcjtcbn1cblxudHlwZSBTa2lwSnNFcnJvcnNPcHRpb25WYWx1ZSA9IFNraXBKc0Vycm9yc09wdGlvbnNPYmplY3QgfCBib29sZWFuO1xuXG5pbnRlcmZhY2UgVGVzdGluZ0VudHJ5SG9va3Mge1xuICAgIGJlZm9yZT86IEZ1bmN0aW9uO1xuICAgIGFmdGVyPzogRnVuY3Rpb247XG59XG5cbmludGVyZmFjZSBHbG9iYWxIb29rcyB7XG4gICAgdGVzdFJ1bj86IFRlc3RpbmdFbnRyeUhvb2tzO1xuICAgIGZpeHR1cmU/OiBUZXN0aW5nRW50cnlIb29rcztcbiAgICB0ZXN0PzogVGVzdGluZ0VudHJ5SG9va3M7XG4gICAgcmVxdWVzdD86IHR5cGVvZiBSZXF1ZXN0SG9va1tdIHwgdHlwZW9mIFJlcXVlc3RIb29rO1xufVxuXG50eXBlIEN1c3RvbUFjdGlvbnMgPSB7IFtuYW1lOiBzdHJpbmddOiAoKSA9PiB2b2lkIH1cblxuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFyc1xudHlwZSBPcHRpb25WYWx1ZSA9IHVuZGVmaW5lZCB8IG51bGwgfCBzdHJpbmcgfCBib29sZWFuIHwgbnVtYmVyIHwgc3RyaW5nW10gfCBGdW5jdGlvbiB8IHsgW2tleTogc3RyaW5nXTogYW55IH0gfCBTY3JlZW5zaG90T3B0aW9uVmFsdWUgfCBRdWFyYW50aW5lT3B0aW9uVmFsdWUgfCBDb21waWxlck9wdGlvbnMgfCBHbG9iYWxIb29rcyB8IFNraXBKc0Vycm9yc09wdGlvblZhbHVlIHwgQ3VzdG9tQWN0aW9ucztcbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlndXJhdGlvbi90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLDJCQUEyQixDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJjb25zdCBSZXF1ZXN0SG9vayA9IHJlcXVpcmUoJy4uL2FwaS9yZXF1ZXN0LWhvb2tzL2hvb2snKTtcblxuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFyc1xudHlwZSBUZW1wbGF0ZUFyZ3VtZW50cyA9IGFueVtdO1xuXG5pbnRlcmZhY2UgU2NyZWVuc2hvdE9wdGlvblZhbHVlIHtcbiAgICBwYXRoOiBzdHJpbmc7XG4gICAgdGFrZU9uRmFpbHM/OiBib29sZWFuO1xuICAgIHBhdGhQYXR0ZXJuPzogc3RyaW5nO1xuICAgIGZ1bGxQYWdlPzogYm9vbGVhbjtcbiAgICB0aHVtYm5haWxzPzogYm9vbGVhbjtcbiAgICBhdXRvVGFrZU9uRmFpbHM/OiBib29sZWFuO1xufVxuXG5pbnRlcmZhY2UgUXVhcmFudGluZU9wdGlvblZhbHVlIHtcbiAgICBhdHRlbXB0TGltaXQ/OiBudW1iZXI7XG4gICAgc3VjY2Vzc1RocmVzaG9sZD86IG51bWJlcjtcbn1cblxudHlwZSBTa2lwSnNFcnJvcnNPcHRpb25WYWx1ZSA9IFNraXBKc0Vycm9yc09wdGlvbnNPYmplY3QgfCBib29sZWFuO1xuXG5pbnRlcmZhY2UgVGVzdGluZ0VudHJ5SG9va3Mge1xuICAgIGJlZm9yZT86IEZ1bmN0aW9uO1xuICAgIGFmdGVyPzogRnVuY3Rpb247XG59XG5cbmludGVyZmFjZSBHbG9iYWxIb29rcyB7XG4gICAgdGVzdFJ1bj86IFRlc3RpbmdFbnRyeUhvb2tzO1xuICAgIGZpeHR1cmU/OiBUZXN0aW5nRW50cnlIb29rcztcbiAgICB0ZXN0PzogVGVzdGluZ0VudHJ5SG9va3M7XG4gICAgcmVxdWVzdD86IHR5cGVvZiBSZXF1ZXN0SG9va1tdIHwgdHlwZW9mIFJlcXVlc3RIb29rO1xufVxuXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG50eXBlIE9wdGlvblZhbHVlID0gdW5kZWZpbmVkIHwgbnVsbCB8IHN0cmluZyB8IGJvb2xlYW4gfCBudW1iZXIgfCBzdHJpbmdbXSB8IEZ1bmN0aW9uIHwgeyBba2V5OiBzdHJpbmddOiBhbnkgfSB8IFNjcmVlbnNob3RPcHRpb25WYWx1ZSB8IFF1YXJhbnRpbmVPcHRpb25WYWx1ZSB8IENvbXBpbGVyT3B0aW9ucyB8IEdsb2JhbEhvb2tzIHwgU2tpcEpzRXJyb3JzT3B0aW9uVmFsdWUgfCBDdXN0b21BY3Rpb25zO1xuIl19

package/package.json

@@ -2,7 +2,7 @@
   "name": "testcafe",
   "description": "Automated browser testing for the modern web development stack.",
   "license": "MIT",
-  "version": "2.2.0-rc.2",
+  "version": "2.2.0",
   "author": {
     "name": "Developer Express Inc.",
     "url": "https://www.devexpress.com/"

package/ts-defs/index.d.ts

@@ -1769,6 +1769,10 @@ declare module 'testcafe' {
             url: URL;
         }
 
+        interface CustomActions {
+            [key: string]: (...args: any[]) => TestControllerPromise
+        }
+
         type ScrollPosition = 'top' | 'right' | 'bottom' | 'left' | 'topRight' | 'topLeft' | 'bottomRight' | 'bottomLeft' | 'center';
 
         interface TestController {
@@ -1784,6 +1788,10 @@ declare module 'testcafe' {
              * Returns an object that contains browser information.
              */
             readonly browser: Browser;
+            /**
+             * Returns an object that contains registered custom actions.
+             */
+            readonly customActions: CustomActions;
             /**
              * Dispatches an event over a specified webpage element.
              *

package/ts-defs/selectors.d.ts

@@ -1767,6 +1767,10 @@ declare module 'testcafe' {
             url: URL;
         }
 
+        interface CustomActions {
+            [key: string]: (...args: any[]) => TestControllerPromise
+        }
+
         type ScrollPosition = 'top' | 'right' | 'bottom' | 'left' | 'topRight' | 'topLeft' | 'bottomRight' | 'bottomLeft' | 'center';
 
         interface TestController {
@@ -1782,6 +1786,10 @@ declare module 'testcafe' {
              * Returns an object that contains browser information.
              */
             readonly browser: Browser;
+            /**
+             * Returns an object that contains registered custom actions.
+             */
+            readonly customActions: CustomActions;
             /**
              * Dispatches an event over a specified webpage element.
              *

package/ts-defs/testcafe-scripts.d.ts

@@ -1767,6 +1767,10 @@ declare module 'testcafe' {
             url: URL;
         }
 
+        interface CustomActions {
+            [key: string]: (...args: any[]) => TestControllerPromise
+        }
+
         type ScrollPosition = 'top' | 'right' | 'bottom' | 'left' | 'topRight' | 'topLeft' | 'bottomRight' | 'bottomLeft' | 'center';
 
         interface TestController {
@@ -1782,6 +1786,10 @@ declare module 'testcafe' {
              * Returns an object that contains browser information.
              */
             readonly browser: Browser;
+            /**
+             * Returns an object that contains registered custom actions.
+             */
+            readonly customActions: CustomActions;
             /**
              * Dispatches an event over a specified webpage element.
              *