codeceptjs 3.1.3 → 3.2.3

package/docs/build/Appium.js

@@ -331,6 +331,7 @@ class Appium extends Webdriver {
    *
    * @param {*} caps
    * @param {*} fn
+   * @return {Promise<any>}
    */
   async runOnIOS(caps, fn) {
     if (this.platform !== 'ios') return;
@@ -373,6 +374,7 @@ class Appium extends Webdriver {
    *
    * @param {*} caps
    * @param {*} fn
+   * @return {Promise<any>}
    */
   async runOnAndroid(caps, fn) {
     if (this.platform !== 'android') return;
@@ -393,6 +395,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {*} fn
+   * @return {Promise<any>}
    */
   /* eslint-disable */
   async runInWeb(fn) {
@@ -434,6 +437,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {string} bundleId String  ID of bundled app
+   * @return {Promise<void>}
    *
    * Appium: support only Android
    */
@@ -451,6 +455,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {string} bundleId String  ID of bundled app
+   * @return {Promise<void>}
    *
    * Appium: support only Android
    */
@@ -467,6 +472,7 @@ class Appium extends Webdriver {
    * I.installApp('/path/to/file.apk');
    * ```
    * @param {string} path path to apk file
+   * @return {Promise<void>}
    *
    * Appium: support only Android
    */
@@ -508,6 +514,7 @@ class Appium extends Webdriver {
    * I.seeCurrentActivityIs(".HomeScreenActivity")
    * ```
    * @param {string} currentActivity
+   * @return {Promise<void>}
    *
    * Appium: support only Android
    */
@@ -524,6 +531,8 @@ class Appium extends Webdriver {
    * I.seeDeviceIsLocked();
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only Android
    */
   async seeDeviceIsLocked() {
@@ -539,6 +548,8 @@ class Appium extends Webdriver {
    * I.seeDeviceIsUnlocked();
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only Android
    */
   async seeDeviceIsUnlocked() {
@@ -555,6 +566,8 @@ class Appium extends Webdriver {
    * I.seeOrientationIs('LANDSCAPE')
    * ```
    *
+   * @return {Promise<void>}
+   *
    * @param {'LANDSCAPE'|'PORTRAIT'} orientation LANDSCAPE or PORTRAIT
    *
    * Appium: support Android and iOS
@@ -586,6 +599,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {'LANDSCAPE'|'PORTRAIT'} orientation LANDSCAPE or PORTRAIT
+   * @return {Promise<any>}
    *
    * Appium: support Android and iOS
    */
@@ -609,6 +623,8 @@ class Appium extends Webdriver {
    * let contexts = await I.grabAllContexts();
    * ```
    *
+   * @return {Promise<string[]>}
+   *
    * Appium: support Android and iOS
    */
   async grabAllContexts() {
@@ -623,6 +639,8 @@ class Appium extends Webdriver {
    * let context = await I.grabContext();
    * ```
    *
+   * @return {Promise<string|null>}
+   *
    * Appium: support Android and iOS
    */
   async grabContext() {
@@ -637,6 +655,8 @@ class Appium extends Webdriver {
    * let activity = await I.grabCurrentActivity();
    * ```
    *
+   * @return {Promise<string>}
+   *
    * Appium: support only Android
    */
   async grabCurrentActivity() {
@@ -653,6 +673,8 @@ class Appium extends Webdriver {
    * let con = await I.grabNetworkConnection();
    * ```
    *
+   * @return {Promise<{}>}
+   *
    * Appium: support only Android
    */
   async grabNetworkConnection() {
@@ -673,6 +695,8 @@ class Appium extends Webdriver {
    * let orientation = await I.grabOrientation();
    * ```
    *
+   * @return {Promise<string>}
+   *
    * Appium: support Android and iOS
    */
   async grabOrientation() {
@@ -689,6 +713,8 @@ class Appium extends Webdriver {
    * let settings = await I.grabSettings();
    * ```
    *
+   * @return {Promise<string>}
+   *
    * Appium: support Android and iOS
    */
   async grabSettings() {
@@ -720,6 +746,8 @@ class Appium extends Webdriver {
    * I.switchToWeb('WEBVIEW_io.selendroid.testapp');
    * ```
    *
+   * @return {Promise<void>}
+   *
    * @param {string} [context]
    */
   async switchToWeb(context) {
@@ -747,6 +775,7 @@ class Appium extends Webdriver {
    * I.switchToNative('SOME_OTHER_CONTEXT');
    * ```
    * @param {*} context
+   * @return {Promise<void>}
    */
   async switchToNative(context = null) {
     this.isWeb = false;
@@ -763,6 +792,8 @@ class Appium extends Webdriver {
    * I.startActivity('io.selendroid.testapp', '.RegisterUserActivity');
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only Android
    */
   async startActivity(appPackage, appActivity) {
@@ -786,6 +817,8 @@ class Appium extends Webdriver {
    * ```
    * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setNetworkConnection.html).
    *
+   * @return {Promise<{}>}
+   *
    * Appium: support only Android
    */
   async setNetworkConnection(value) {
@@ -801,6 +834,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {object} settings object
+   * @return {Promise<any>}
    *
    * Appium: support Android and iOS
    */
@@ -841,6 +875,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {number} keyValue  Device specific key value
+   * @return {Promise<void>}
    *
    * Appium: support only Android
    */
@@ -859,6 +894,8 @@ class Appium extends Webdriver {
    * I.openNotifications();
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only Android
    */
   async openNotifications() {
@@ -877,6 +914,8 @@ class Appium extends Webdriver {
    * I.makeTouchAction("~buttonStartWebviewCD", 'tap');
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support Android and iOS
    */
   async makeTouchAction(locator, action) {
@@ -898,6 +937,8 @@ class Appium extends Webdriver {
    *
    * Shortcut for `makeTouchAction`
    *
+   * @return {Promise<void>}
+   *
    * @param {*} locator
    */
   async tap(locator) {
@@ -918,6 +959,7 @@ class Appium extends Webdriver {
    * @param {number} xoffset
    * @param {number} yoffset
    * @param {number} [speed=1000] (optional), 1000 by default
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -971,6 +1013,7 @@ class Appium extends Webdriver {
    * @param {CodeceptJS.LocatorOrString} locator
    * @param {number} [yoffset] (optional)
    * @param {number} [speed=1000] (optional), 1000 by default
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -999,6 +1042,7 @@ class Appium extends Webdriver {
    * @param {CodeceptJS.LocatorOrString} locator
    * @param {number} [xoffset] (optional)
    * @param {number} [speed=1000] (optional), 1000 by default
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -1025,6 +1069,7 @@ class Appium extends Webdriver {
    * @param {CodeceptJS.LocatorOrString} locator
    * @param {number} [xoffset] (optional)
    * @param {number} [speed=1000] (optional), 1000 by default
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -1051,6 +1096,7 @@ class Appium extends Webdriver {
    * @param {CodeceptJS.LocatorOrString} locator
    * @param {number} [yoffset] (optional)
    * @param {number} [speed=1000] (optional), 1000 by default
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -1084,6 +1130,7 @@ class Appium extends Webdriver {
    * @param {number} timeout
    * @param {number} offset
    * @param {number} speed
+   * @return {Promise<void>}
    *
    * Appium: support Android and iOS
    */
@@ -1181,6 +1228,10 @@ class Appium extends Webdriver {
    * I.pullFile('/storage/emulated/0/DCIM/logo.png', output_dir);
    * ```
    *
+   * @param {string} path
+   * @param {string} dest
+   * @return {Promise<string>}
+   *
    * Appium: support Android and iOS
    */
   async pullFile(path, dest) {
@@ -1200,6 +1251,8 @@ class Appium extends Webdriver {
    * I.shakeDevice();
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only iOS
    */
   async shakeDevice() {
@@ -1216,6 +1269,8 @@ class Appium extends Webdriver {
    *
    * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/rotate.html).
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only iOS
    */
   async rotate(x, y, duration, radius, rotation, touchCount) {
@@ -1228,6 +1283,8 @@ class Appium extends Webdriver {
    *
    * See corresponding [webdriverio reference](http://webdriver.io/api/mobile/setImmediateValue.html).
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only iOS
    */
   async setImmediateValue(id, value) {
@@ -1244,6 +1301,8 @@ class Appium extends Webdriver {
    * I.touchId(false); // simulates invalid fingerprint
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only iOS
    * TODO: not tested
    */
@@ -1260,6 +1319,8 @@ class Appium extends Webdriver {
    * I.closeApp();
    * ```
    *
+   * @return {Promise<void>}
+   *
    * Appium: support only iOS
    */
   async closeApp() {
@@ -1564,6 +1625,7 @@ class Appium extends Webdriver {
    * ```
    *
    * @param {string} fileName file name to save.
+   * @return {Promise<void>}
    */
   async saveScreenshot(fileName) {
     return super.saveScreenshot(fileName, false);

package/docs/build/FileSystem.js

@@ -15,7 +15,17 @@ const { fileEquals } = require('../assert/equal');
  * I.amInPath('test');
  * I.seeFile('codecept.json');
  * I.seeInThisFile('FileSystem');
- * I.dontSeeInThisFile("WebDriverIO");
+ * I.dontSeeInThisFile("WebDriver");
+ * ```
+ *
+ * ## Configuration
+ *
+ * Enable helper in config file:
+ *
+ * ```js
+ * helpers: {
+ *     FileSystem: {},
+ * }
  * ```
  *
  * ## Methods
@@ -91,6 +101,7 @@ class FileSystem extends Helper {
   * I.amInPath('output/downloads');
   * I.seeFileNameMatching('.pdf');
   * ```
+  * @param {string} text
   */
   seeFileNameMatching(text) {
     assert.ok(

package/docs/build/Playwright.js

@@ -14,7 +14,6 @@ const {
   ucfirst,
   fileExists,
   chunkArray,
-  toCamelCase,
   convertCssPropertiesToCamelCase,
   screenshotOutputFolder,
   getNormalizedKeyAttributeValue,
@@ -73,16 +72,18 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * * `keepBrowserState`: (optional, default: false) - keep browser state between tests when `restart` is set to false.
  * * `keepCookies`: (optional, default: false) - keep cookies between tests when `restart` is set to false.
  * * `waitForAction`: (optional) how long to wait after click, doubleClick or PressKey actions in ms. Default: 100.
- * * `waitForNavigation`: (optional, default: 'load'). When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API](https://github.com/microsoft/playwright/blob/master/docs/api.md#pagewaitfornavigationoptions).
+ * * `waitForNavigation`: (optional, default: 'load'). When to consider navigation succeeded. Possible options: `load`, `domcontentloaded`, `networkidle`. Choose one of those options is possible. See [Playwright API](https://github.com/microsoft/playwright/blob/main/docs/api.md#pagewaitfornavigationoptions).
  * * `pressKeyDelay`: (optional, default: '10'). Delay between key presses in ms. Used when calling Playwrights page.type(...) in fillField/appendField
  * * `getPageTimeout` (optional, default: '0') config option to set maximum navigation time in milliseconds.
  * * `waitForTimeout`: (optional) default wait* timeout in ms. Default: 1000.
  * * `basicAuth`: (optional) the basic authentication to pass to base url. Example: {username: 'username', password: 'password'}
  * * `windowSize`: (optional) default window size. Set a dimension like `640x480`.
  * * `userAgent`: (optional) user-agent string.
+ * * `locale`: (optional) locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
  * * `manualStart`: (optional, default: false) - do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
  * * `chromium`: (optional) pass additional chromium options
  * * `electron`: (optional) pass additional electron options
+ * * `channel`: (optional) While Playwright can operate against the stock Google Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels of these browsers. See [Google Chrome & Microsoft Edge](https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge).
  *
  * #### Video Recording Customization
  *
@@ -197,6 +198,19 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * }
  * ```
  *
+ * #### Example #7: Launch test with a specifc user locale
+ *
+ * ```js
+ * {
+ *  helpers: {
+ *   Playwright : {
+ *     url: "http://localhost",
+ *     locale: "fr-FR",
+ *   }
+ *  }
+ * }
+ * ```
+ *
  * Note: When connecting to remote browser `show` and specific `chrome` options (e.g. `headless` or `devtools`) are ignored.
  *
  * ## Access From Helpers
@@ -287,6 +301,11 @@ class Playwright extends Helper {
       headless: !this.options.show,
       ...this._getOptionsForBrowser(config),
     };
+
+    if (this.options.channel && this.options.browser === 'chromium') {
+      this.playwrightOptions.channel = this.options.channel;
+    }
+
     if (this.options.video) {
       this.options.recordVideo = { size: parseWindowSize(this.options.windowSize) };
     }
@@ -351,6 +370,7 @@ class Playwright extends Helper {
         return err.message.includes('context');
       },
     });
+
     if (this.options.restart && !this.options.manualStart) await this._startBrowser();
     if (!this.isRunning && !this.options.manualStart) await this._startBrowser();
 
@@ -371,6 +391,8 @@ class Playwright extends Helper {
       }
       if (this.options.recordVideo) contextOptions.recordVideo = this.options.recordVideo;
       if (this.storageState) contextOptions.storageState = this.storageState;
+      if (this.options.userAgent) contextOptions.userAgent = this.options.userAgent;
+      if (this.options.locale) contextOptions.locale = this.options.locale;
       this.browserContext = await this.browser.newContext(contextOptions); // Adding the HTTPSError ignore in the context so that we can ignore those errors
     }
 
@@ -484,10 +506,10 @@ class Playwright extends Helper {
   * First argument is a description of an action.
   * Second argument is async function that gets this helper as parameter.
   *
-  * { [`page`](https://github.com/microsoft/playwright/blob/master/docs/api.md#class-page), [`context`](https://github.com/microsoft/playwright/blob/master/docs/api.md#class-context) [`browser`](https://github.com/microsoft/playwright/blob/master/docs/api.md#class-browser) } objects from Playwright API are available.
+  * { [`page`](https://github.com/microsoft/playwright/blob/main/docs/src/api/class-page.md), [`context`](https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browsercontext.md) [`browser`](https://github.com/microsoft/playwright/blob/main/docs/src/api/class-browser.md) } objects from Playwright API are available.
   *
   * ```js
-  * I.usePlaywrightTo('emulate offline mode', async ({ context }) {
+  * I.usePlaywrightTo('emulate offline mode', async ({ context }) => {
   *   await context.setOffline(true);
   * });
   * ```
@@ -569,6 +591,11 @@ class Playwright extends Helper {
     this.page = page;
     if (!page) return;
     page.setDefaultNavigationTimeout(this.options.getPageTimeout);
+
+    page.on('crash', async () => {
+      console.log('ERROR: Page has crashed, closing page!');
+      await page.close();
+    });
     this.context = await this.page;
     this.contextLocator = null;
     if (this.options.browser === 'chrome') {
@@ -1147,7 +1174,7 @@ class Playwright extends Helper {
    * I.openNewTab();
    * ```
    *
-   * You can pass in [page options](https://github.com/microsoft/playwright/blob/master/docs/api.md#browsernewpageoptions) to emulate device on this page
+   * You can pass in [page options](https://github.com/microsoft/playwright/blob/main/docs/api.md#browsernewpageoptions) to emulate device on this page
    *
    * ```js
    * // enable mobile
@@ -2135,7 +2162,7 @@ class Playwright extends Helper {
    */
   async clearCookie() {
     // Playwright currently doesn't support to delete a certain cookie
-    // https://github.com/microsoft/playwright/blob/master/docs/api.md#class-browsercontext
+    // https://github.com/microsoft/playwright/blob/main/docs/api.md#class-browsercontext
     if (!this.browserContext) return;
     return this.browserContext.clearCookies();
   }
@@ -2580,7 +2607,7 @@ class Playwright extends Helper {
     }
 
     if (this.options.trace) {
-      const path = `${global.output_dir}/trace/${clearString(test.title).slice(0, 255)}.zip`;
+      const path = `${`${global.output_dir}/trace/${clearString(test.title)}`.slice(0, 251)}.zip`;
       await this.browserContext.tracing.stop({ path });
       test.artifacts.trace = path;
     }
@@ -2956,11 +2983,11 @@ class Playwright extends Helper {
   }
 
   /**
-   * Waits for a network request.
+   * Waits for a network response.
    *
    * ```js
    * I.waitForResponse('http://example.com/resource');
-   * I.waitForResponse(request => request.url() === 'http://example.com' && request.method() === 'GET');
+   * I.waitForResponse(response => response.url() === 'https://example.com' && response.status() === 200);
    * ```
    *
    * @param {string|function} urlOrPredicate
@@ -3069,26 +3096,6 @@ class Playwright extends Helper {
     return this.page.waitForNavigation(opts);
   }
 
-  /**
-   * Waits for a function to return true (waits for 1sec by default).
-   * 
-   * ```js
-   * I.waitUntil(() => window.requests == 0);
-   * I.waitUntil(() => window.requests == 0, 5);
-   * ```
-   * 
-   * @param {function|string} fn function which is executed in browser context.
-   * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @param {string} [timeoutMsg=''] message to show in case of timeout fail.
-   * @param {?number} [interval=null]
-   */
-  async waitUntil(fn, sec = null) {
-    console.log('This method will remove in CodeceptJS 1.4; use `waitForFunction` instead!');
-    const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout;
-    const context = await this._getContext();
-    return context.waitForFunction(fn, { timeout: waitTimeout });
-  }
-
   async waitUntilExists(locator, sec) {
     console.log(`waitUntilExists deprecated:
     * use 'waitForElement' to wait for element to be attached
@@ -3551,13 +3558,10 @@ async function targetCreatedHandler(page) {
       });
   });
   page.on('console', (msg) => {
-    this.debugSection(`Browser:${ucfirst(msg.type())}`, (msg._text || '') + msg.args().join(' '));
+    this.debugSection(`Browser:${ucfirst(msg.type())}`, (msg.text && msg.text() || msg._text || '') + msg.args().join(' '));
     consoleLogStore.add(msg);
   });
 
-  if (this.options.userAgent) {
-    await page.setUserAgent(this.options.userAgent);
-  }
   if (this.options.windowSize && this.options.windowSize.indexOf('x') > 0 && this._getType() === 'Browser') {
     await page.setViewportSize(parseWindowSize(this.options.windowSize));
   }

package/docs/build/Protractor.js

@@ -1181,11 +1181,14 @@ class Protractor extends Helper {
   }
 
   /**
-   * Checks that title is equal to provided one.
-   *
-   * ```js
-   * I.seeTitleEquals('Test title.');
-   * ```
+   *  Checks that title is equal to provided one.
+   * 
+   *  ```js
+   *  I.seeTitleEquals('Test title.');
+   *  ```
+   * 
+   *  @param {string} text value to check.
+   * 
    */
   async seeTitleEquals(text) {
     const title = await this.browser.getTitle();
@@ -1509,7 +1512,7 @@ class Protractor extends Helper {
   }
 
   /**
-     * Checks that current url contains a provided fragment.
+   * Checks that current url contains a provided fragment.
    * 
    * ```js
    * I.seeInCurrentUrl('/register'); // we are on registration page
@@ -2184,24 +2187,6 @@ class Protractor extends Helper {
     return this.browser.wait(() => this.browser.executeScript.call(this.browser, fn, ...args), aSec * 1000);
   }
 
-  /**
-   * Waits for a function to return true (waits for 1sec by default).
-   * 
-   * ```js
-   * I.waitUntil(() => window.requests == 0);
-   * I.waitUntil(() => window.requests == 0, 5);
-   * ```
-   * 
-   * @param {function|string} fn function which is executed in browser context.
-   * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @param {string} [timeoutMsg=''] message to show in case of timeout fail.
-   * @param {?number} [interval=null]
-   */
-  async waitUntil(fn, sec = null, timeoutMsg = null) {
-    const aSec = sec || this.options.waitForTimeout;
-    return this.browser.wait(fn, aSec * 1000, timeoutMsg);
-  }
-
   /**
    * Waiting for the part of the URL to match the expected. Useful for SPA to understand that page was changed.
    * 

package/docs/build/Puppeteer.js

@@ -264,7 +264,7 @@ class Puppeteer extends Helper {
   async _before() {
     this.sessionPages = {};
     recorder.retry({
-      retries: 5,
+      retries: 3,
       when: err => {
         if (!err || typeof (err.message) !== 'string') {
           return false;
@@ -561,10 +561,9 @@ class Puppeteer extends Helper {
     this.context = null;
     popupStore.clear();
     this.isAuthenticated = false;
+    await this.browser.close();
     if (this.isRemoteBrowser) {
       await this.browser.disconnect();
-    } else {
-      await this.browser.close();
     }
   }
 
@@ -852,11 +851,14 @@ class Puppeteer extends Helper {
   }
 
   /**
-   * Checks that title is equal to provided one.
-   *
-   * ```js
-   * I.seeTitleEquals('Test title.');
-   * ```
+   *  Checks that title is equal to provided one.
+   * 
+   *  ```js
+   *  I.seeTitleEquals('Test title.');
+   *  ```
+   * 
+   *  @param {string} text value to check.
+   * 
    */
   async seeTitleEquals(text) {
     const title = await this.page.title();
@@ -3102,26 +3104,6 @@ class Puppeteer extends Helper {
     return this.page.waitForNavigation(opts);
   }
 
-  /**
-   * Waits for a function to return true (waits for 1sec by default).
-   * 
-   * ```js
-   * I.waitUntil(() => window.requests == 0);
-   * I.waitUntil(() => window.requests == 0, 5);
-   * ```
-   * 
-   * @param {function|string} fn function which is executed in browser context.
-   * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @param {string} [timeoutMsg=''] message to show in case of timeout fail.
-   * @param {?number} [interval=null]
-   */
-  async waitUntil(fn, sec = null) {
-    console.log('This method will remove in CodeceptJS 1.4; use `waitForFunction` instead!');
-    const waitTimeout = sec ? sec * 1000 : this.options.waitForTimeout;
-    const context = await this._getContext();
-    return context.waitForFunction(fn, { timeout: waitTimeout });
-  }
-
   async waitUntilExists(locator, sec) {
     console.log(`waitUntilExists deprecated:
     * use 'waitForElement' to wait for element to be attached

package/docs/build/REST.js

@@ -131,6 +131,7 @@ class REST extends Helper {
    * I.setRequestTimeout(10000); // In milliseconds
    * ```
    *
+   * @param {number} newTimeout - timeout in milliseconds
    */
   setRequestTimeout(newTimeout) {
     this.options.timeout = newTimeout;