testcafe 1.20.2-alpha.1 → 2.0.0-rc.3

package/package.json

@@ -2,7 +2,7 @@
   "name": "testcafe",
   "description": "Automated browser testing for the modern web development stack.",
   "license": "MIT",
-  "version": "1.20.2-alpha.1",
+  "version": "2.0.0-rc.3",
   "author": {
     "name": "Developer Express Inc.",
     "url": "https://www.devexpress.com/"
@@ -149,7 +149,7 @@
     "time-limit-promise": "^1.0.2",
     "tmp": "0.0.28",
     "tree-kill": "^1.2.2",
-    "typescript": "^3.3.3",
+    "typescript": "^4.7.4",
     "unquote": "^1.1.1"
   },
   "devDependencies": {
@@ -171,8 +171,8 @@
     "@types/semver": "^7.3.4",
     "@types/source-map-support": "^0.5.0",
     "@types/useragent": "^2.1.1",
-    "@typescript-eslint/eslint-plugin": "2.0.0",
-    "@typescript-eslint/parser": "^2.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.29.0",
+    "@typescript-eslint/parser": "^5.29.0",
     "babel-plugin-add-module-exports": "^0.2.0",
     "basic-auth": "^1.1.0",
     "body-parser": "^1.17.1",
@@ -185,6 +185,7 @@
     "devtools-protocol": "0.0.1030018",
     "dom-walk": "^0.1.1",
     "escape-string-regexp": "^4.0.0",
+    "eslint": "^7.13.0",
     "eslint-plugin-hammerhead": "0.4.0",
     "eslint-plugin-no-only-tests": "^2.0.1",
     "express": "^4.13.3",
@@ -193,7 +194,7 @@
     "gulp-babel": "^6.1.1",
     "gulp-clone": "^2.0.1",
     "gulp-data": "^1.3.1",
-    "gulp-eslint": "^5.0.0",
+    "gulp-eslint": "^6.0.0",
     "gulp-gh-pages": "^0.6.0-6",
     "gulp-git": "^2.4.2",
     "gulp-less": "^4.0.0",
@@ -222,7 +223,7 @@
     "recursive-copy": "^2.0.5",
     "request": "^2.58.0",
     "rollup": "2.16.1",
-    "rollup-plugin-typescript2": "^0.26.0",
+    "rollup-plugin-typescript2": "^0.32.1",
     "run-sequence": "^1.2.2",
     "saucelabs-connector": "^1.0.0",
     "serve-static": "^1.10.0",
@@ -230,7 +231,7 @@
     "stack-chain": "^2.0.0",
     "strip-ansi": "^3.0.0",
     "testcafe-browser-provider-browserstack": "^1.14.0-alpha.1",
-    "tslib": "^1.11.1",
+    "tslib": "^2.4.0",
     "uglify-js": "~3.10.4"
   }
 }

package/ts-defs/index.d.ts

@@ -1577,6 +1577,13 @@ declare module 'testcafe' {
              * @param scripts - Scripts that should be added to the tested pages.
              */
             clientScripts (scripts: ClientScript | ClientScript[]): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestFn {
@@ -1663,8 +1670,17 @@ declare module 'testcafe' {
              *
              */
             timeouts(testTimeouts: TestTimeouts): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
+        // // 
+
         interface NativeDialogHistoryItem {
             /**
              * The type of the native dialog.
@@ -2189,6 +2205,13 @@ declare module 'testcafe' {
              * @param options - options.
              */
             request: Request;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestControllerPromise<T=any> extends TestController, Promise<T> {
@@ -2359,6 +2382,22 @@ declare module 'testcafe' {
             patch(urlOpts: RequestUrlOpts, options?: RequestOptions): RequestPromise;
         }
 
+        // // SkipJsErrors API
+        //----------------------------------------------------------------------------------------------------------------------
+
+        type SkipJsErrorsCallback = (opts?: {message: string; stack: string; pageUrl: string }) => boolean;
+
+        interface SkipJsErrorsCallbackWithOptionsObject {
+            fn: SkipJsErrorsCallback;
+            dependencies?: { [key: string]: any };
+        }
+
+        interface SkipJsErrorsOptionsObject {
+            message?: string | RegExp;
+            stack?: string | RegExp;
+            pageUrl?: string | RegExp;
+        }
+
         type TlsOptions = import('tls').TlsOptions;
 
         interface AppOptions {
@@ -2547,9 +2586,9 @@ declare module 'testcafe' {
 
         interface RunOptions {
             /**
-             * Defines whether to continue running a test after a JavaScript error occurs on a page (`true`), or consider such a test failed (`false`).
+             * Defines the framework's response to client-side JavaScript errors. If `false` (the default value), tests fail after the website yields a client-side error. If `true`, TestCafe ignores JavaScript errors. Additional options set custom error handling criteria.
              */
-            skipJsErrors: boolean;
+            skipJsErrors: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject;
             /**
              * Defines whether to continue running a test after an uncaught error or unhandled promise rejection occurs on the server (`true`), or consider such a test failed (`false`).
              */
@@ -2734,8 +2773,8 @@ declare module 'testcafe' {
              * @param pathPattern - The pattern to compose screenshot files' relative path and name.
              */
             screenshots(
-                path:         ScreenshotsOptions['path'], 
-                takeOnFails?: ScreenshotsOptions['takeOnFails'], 
+                path:         ScreenshotsOptions['path'],
+                takeOnFails?: ScreenshotsOptions['takeOnFails'],
                 pathPattern?: ScreenshotsOptions['pathPattern']
             ): this;
 
@@ -2757,8 +2796,8 @@ declare module 'testcafe' {
              * @param encodingOptions - Video encoding options
              */
             video(
-                path: VideoConfigOptions['path'], 
-                options?: VideoConfigOptions['options'], 
+                path: VideoConfigOptions['path'],
+                options?: VideoConfigOptions['options'],
                 encodingOptions?: VideoConfigOptions['encodingOptions']
             ): this;
 
@@ -2834,7 +2873,7 @@ declare module 'testcafe' {
             // NOTE: Positional arguments support is left only for backward compatibility.
             // It should be removed in future TestCafe versions.
             // All new APIs should be enabled trough the configuration object in the upper clause.
-            // Please do not add new APIs here. 
+            // Please do not add new APIs here.
             (
                 hostname?: StartOptions['hostname'],
                 port1?: StartOptions['port1'],

package/ts-defs/selectors.d.ts

@@ -1575,6 +1575,13 @@ declare module 'testcafe' {
              * @param scripts - Scripts that should be added to the tested pages.
              */
             clientScripts (scripts: ClientScript | ClientScript[]): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestFn {
@@ -1661,8 +1668,17 @@ declare module 'testcafe' {
              *
              */
             timeouts(testTimeouts: TestTimeouts): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
+        // // 
+
         interface NativeDialogHistoryItem {
             /**
              * The type of the native dialog.
@@ -2187,6 +2203,13 @@ declare module 'testcafe' {
              * @param options - options.
              */
             request: Request;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestControllerPromise<T=any> extends TestController, Promise<T> {
@@ -2357,6 +2380,22 @@ declare module 'testcafe' {
             patch(urlOpts: RequestUrlOpts, options?: RequestOptions): RequestPromise;
         }
 
+        // // SkipJsErrors API
+        //----------------------------------------------------------------------------------------------------------------------
+
+        type SkipJsErrorsCallback = (opts?: {message: string; stack: string; pageUrl: string }) => boolean;
+
+        interface SkipJsErrorsCallbackWithOptionsObject {
+            fn: SkipJsErrorsCallback;
+            dependencies?: { [key: string]: any };
+        }
+
+        interface SkipJsErrorsOptionsObject {
+            message?: string | RegExp;
+            stack?: string | RegExp;
+            pageUrl?: string | RegExp;
+        }
+
         /**
          * Creates a selector.
          *

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

@@ -1575,6 +1575,13 @@ declare module 'testcafe' {
              * @param scripts - Scripts that should be added to the tested pages.
              */
             clientScripts (scripts: ClientScript | ClientScript[]): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestFn {
@@ -1661,8 +1668,17 @@ declare module 'testcafe' {
              *
              */
             timeouts(testTimeouts: TestTimeouts): this;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
+        // // 
+
         interface NativeDialogHistoryItem {
             /**
              * The type of the native dialog.
@@ -2187,6 +2203,13 @@ declare module 'testcafe' {
              * @param options - options.
              */
             request: Request;
+
+            /**
+             * Customize the behavior of the skipJsErrors method.
+             *
+             * @param options - Error skipping conditions: a Boolean flag, an Object with options, or a callback function that defines custom error skipping logic.
+             */
+            skipJsErrors (options?: boolean | SkipJsErrorsOptionsObject | SkipJsErrorsCallback | SkipJsErrorsCallbackWithOptionsObject): this;
         }
 
         interface TestControllerPromise<T=any> extends TestController, Promise<T> {
@@ -2357,6 +2380,22 @@ declare module 'testcafe' {
             patch(urlOpts: RequestUrlOpts, options?: RequestOptions): RequestPromise;
         }
 
+        // // SkipJsErrors API
+        //----------------------------------------------------------------------------------------------------------------------
+
+        type SkipJsErrorsCallback = (opts?: {message: string; stack: string; pageUrl: string }) => boolean;
+
+        interface SkipJsErrorsCallbackWithOptionsObject {
+            fn: SkipJsErrorsCallback;
+            dependencies?: { [key: string]: any };
+        }
+
+        interface SkipJsErrorsOptionsObject {
+            message?: string | RegExp;
+            stack?: string | RegExp;
+            pageUrl?: string | RegExp;
+        }
+
         /**
          * Creates a selector.
          *