Migrate utils modules to TS.

.eslintrc

@@ -1,4 +1,5 @@
 {
+  "root": true,
   "extends": [
     "eslint:recommended"
   ],
@@ -13,6 +14,33 @@
     "mocha": true,
     "node": true
   },
+  "overrides": [
+    {
+      "files": [
+        "**/*.ts"
+      ],
+      "excludedFiles": [
+        "test/**/*.ts"
+      ],
+      "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/eslint-recommended",
+        "plugin:@typescript-eslint/recommended"
+      ],
+      "parser": "@typescript-eslint/parser",
+      "plugins": [
+        "@typescript-eslint"
+      ],
+      "parserOptions": {
+        "ecmaVersion": 2020,
+        "sourceType": "module",
+        "ecmaFeatures": {
+          "jsx": false
+        },
+        "project": "./tsconfig.json"
+      }
+    }
+  ],
   "rules": {
     "eqeqeq": [
       "error",

lib/utils/addDetailedError.js → lib/utils/addDetailedError.ts

@@ -1,9 +1,10 @@
+import {NightwatchError} from './types';
+
 /**
  * @method addDetailedError
- * @param {Error} err
  */
-module.exports = function(err) {
-  let detailedErr;
+export = function(err: NightwatchError) {
+  let detailedErr: string | undefined;
 
   if (err instanceof TypeError) {
     if (err.detailedErr && /browser\..+ is not a function$/.test(err.detailedErr)) {
@@ -25,14 +26,14 @@ module.exports = function(err) {
       detailedErr = '  - writing an ES6 async test case? - keep in mind that commands return a Promise; \n      - writing unit tests? - make sure to specify "unit_tests_mode=true" in your config.';
     }
   } else if (err instanceof SyntaxError) {
-    const stackParts = err.stack.split('SyntaxError:');
-    detailedErr = stackParts[0];
-    let modulePath = err.stack.split('\n')[0];
-    if (modulePath.includes(':')) {
+    const stackParts = err.stack?.split('SyntaxError:');
+    detailedErr = stackParts?.[0];
+    let modulePath = err.stack?.split('\n')[0];
+    if (modulePath?.includes(':')) {
       modulePath = modulePath.split(':')[0];
     }
 
-    if (stackParts[1]) {
+    if (stackParts?.[1]) {
       if (detailedErr) {
         err.stack = '';
       }
@@ -46,7 +47,7 @@ module.exports = function(err) {
       detailedErr = header + detailedErr;
     }
 
-    if (modulePath.endsWith('.jsx') || modulePath.endsWith('.tsx')) {
+    if (modulePath?.endsWith('.jsx') || modulePath?.endsWith('.tsx')) {
       detailedErr = `\n   In order to be able to load JSX files, one of these plugins is needed:
    - @nightwatch/react
    - @nightwatch/storybook (only if using Storybook in your project)

lib/utils/alwaysDisplayError.js → lib/utils/alwaysDisplayError.ts

@@ -1,5 +1,5 @@
-module.exports = function(err) {
+export = function(err: unknown) {
   return (err instanceof Error) && [
     'TypeError', 'SyntaxError', 'ReferenceError', 'RangeError'
   ].includes(err.name);
-};
+};

lib/utils/beautifyStackTrace.js

@@ -2,7 +2,7 @@ const fs = require('fs');
 const stackTraceParser = require('stacktrace-parser');
 const AssertionError = require('assertion-error');
 const {filterStackTrace} = require('./stackTrace.js');
-const alwaysDisplayError = require('./alwaysDisplayError.js');
+const alwaysDisplayError = require('./alwaysDisplayError');
 const {colors} = require('./chalkColors.js');
 
 /**

lib/utils/browsername.js → lib/utils/browsername.ts

@@ -1,27 +1,27 @@
-const BrowserName = module.exports = {
+class BrowserName {
   get CHROME() {
     return 'chrome';
-  },
+  }
 
   get FIREFOX() {
     return 'firefox';
-  },
+  }
 
   get SAFARI() {
     return 'safari';
-  },
+  }
 
   get EDGE() {
     return 'MicrosoftEdge';
-  },
+  }
 
   get INTERNET_EXPLORER() {
     return 'internet explorer';
-  },
+  }
 
   get OPERA() {
     return 'opera';
   }
-};
+}
 
-Object.freeze(BrowserName);
+export = new BrowserName();

lib/utils/createPromise.ts

@@ -0,0 +1,16 @@
+interface Deferred<T> {
+  promise: Promise<T>;
+  resolve: ((value: T | PromiseLike<T>) => void);
+  reject: ((reason?: unknown) => void);
+}
+
+export = function createPromise<T>(): Deferred<T> {
+  const deferred = <Deferred<T>> {};
+
+  deferred.promise = new Promise((resolve, reject) => {
+    deferred.resolve = resolve;
+    deferred.reject = reject;
+  });
+
+  return deferred;
+};

lib/utils/getFreePort.js → lib/utils/getFreePort.ts

@@ -1,20 +1,25 @@
+import * as net from 'net';
+
 /**
  * @method getFreePort
- * @param host
- * @returns {Promise<number>}
  */
-module.exports = function(host = 'localhost') {
-  const net = require('net');
-
+export = function(host = 'localhost'): Promise<number> {
   return new Promise((resolve, reject) => {
     const server = net.createServer();
 
     server.on('listening', function () {
-      resolve(server.address().port);
+      const serverAddress = server.address();
+
+      if (!serverAddress || typeof serverAddress === 'string') {
+        reject(new Error('Unable to get port from server address.'));
+      } else {
+        resolve(serverAddress.port);
+      }
+
       server.close();
     });
 
-    server.on('error', (e) => {
+    server.on('error', (e: NodeJS.ErrnoException) => {
       let err;
       if (e.code === 'EADDRINUSE' || e.code === 'EACCES') {
         err = new Error('Unable to find a free port');
@@ -28,4 +33,4 @@ module.exports = function(host = 'localhost') {
     // By providing 0 we let the operative system find an arbitrary port
     server.listen(0, host);
   });
-};
+};

lib/utils/index.js

@@ -6,16 +6,16 @@ const {By, Capabilities} = require('selenium-webdriver');
 const {inspect} = require('util');
 
 const Logger = require('./logger');
-const BrowserName = require('./browsername.js');
+const BrowserName = require('./browsername');
 const LocateStrategy = require('./locatestrategy.js');
 const PeriodicPromise = require('./periodic-promise.js');
-const createPromise = require('./createPromise.js');
-const isErrorObject = require('./isErrorObject.js');
-const alwaysDisplayError = require('./alwaysDisplayError.js');
+const createPromise = require('./createPromise');
+const isErrorObject = require('./isErrorObject');
+const alwaysDisplayError = require('./alwaysDisplayError');
 const Screenshots = require('./screenshots.js');
 const Snapshots = require('./snapshots.js');
 const TimedCallback = require('./timed-callback.js');
-const getFreePort = require('./getFreePort.js');
+const getFreePort = require('./getFreePort');
 const requireModule = require('./requireModule.js');
 const getAllClassMethodNames = require('./getAllClassMethodNames.js');
 const VERSION = require('./version.js');
@@ -715,7 +715,6 @@ lodashMerge(Utils, {
   Screenshots,
   Snapshots,
   TimedCallback,
-
 
   getFreePort,
   VERSION,

lib/utils/isErrorObject.js → lib/utils/isErrorObject.ts

@@ -1,3 +1,3 @@
-module.exports = function(err) {
+export = function(err: unknown) {
   return err instanceof Error || Object.prototype.toString.call(err) === '[object Error]';
-};
+};

lib/utils/logger/index.js

@@ -7,12 +7,12 @@ const lodashEscape = require('lodash.escape');
 const LogSettings = require('./log_settings.js');
 const chalkColors = require('../chalkColors.js');
 
-const addDetailedError = require('../addDetailedError.js');
+const addDetailedError = require('../addDetailedError');
 
 const Errors = require('../../transport/errors');
 const beautifyStackTrace = require('../beautifyStackTrace');
 
-const alwaysDisplayError = require('../alwaysDisplayError.js');
+const alwaysDisplayError = require('../alwaysDisplayError');
 
 const Severity = {
   LOG: 'LOG',

lib/utils/periodic-promise.js

@@ -1,5 +1,5 @@
 const EventEmitter = require('events');
-const createPromise = require('./createPromise.js');
+const createPromise = require('./createPromise');
 
 class PeriodicPromise extends EventEmitter {
   get rescheduleInterval() {

lib/utils/stackTrace.js

@@ -1,7 +1,7 @@
 const boxen = require('boxen');
 const {colors} = require('./chalkColors.js');
-const isErrorObject = require('./isErrorObject.js');
-const addDetailedError = require('./addDetailedError.js');
+const isErrorObject = require('./isErrorObject');
+const addDetailedError = require('./addDetailedError');
 const indentRegex = /^/gm;
 
 const stackTraceFilter = function (parts) {

lib/utils/types/index.ts

@@ -0,0 +1,5 @@
+export interface NightwatchError extends Error {
+  detailedErr: string;
+  link: string;
+  help: string[];
+}