codeceptjs 3.4.1 → 3.5.1-2.beta.7

package/docs/build/REST.js

@@ -1,334 +0,0 @@
-const axios = require('axios').default;
-const Helper = require('@codeceptjs/helper');
-const Secret = require('../secret');
-
-const { beautify } = require('../utils');
-
-/**
- * ## Configuration
- *
- * @typedef RESTConfig
- * @type {object}
- * @prop {string} [endpoint] - API base URL
- * @prop {boolean} [prettyPrintJson=false] - pretty print json for response/request on console logs
- * @prop {number} [timeout=1000] - timeout for requests in milliseconds. 10000ms by default
- * @prop {object} [defaultHeaders] - a list of default headers
- * @prop {function} [onRequest] - a async function which can update request object.
- * @prop {function} [onResponse] - a async function which can update response object.
- * @prop {number} [maxUploadFileSize] - set the max content file size in MB when performing api calls.
- */
-const config = {};
-
-/**
- * REST helper allows to send additional requests to the REST API during acceptance tests.
- * [Axios](https://github.com/axios/axios) library is used to perform requests.
- *
- * <!-- configuration -->
- *
- * ## Example
- *
- * ```js
- *{
- *   helpers: {
- *     REST: {
- *       endpoint: 'http://site.com/api',
- *       prettyPrintJson: true,
- *       onRequest: (request) => {
- *       request.headers.auth = '123';
- *     }
- *   }
- *}
- * ```
- *
- * ## Access From Helpers
- *
- * Send REST requests by accessing `_executeRequest` method:
- *
- * ```js
- * this.helpers['REST']._executeRequest({
- *    url,
- *    data,
- * });
- * ```
- *
- * ## Methods
- */
-class REST extends Helper {
-  constructor(config) {
-    super(config);
-    this.options = {
-      timeout: 10000,
-      defaultHeaders: {},
-      endpoint: '',
-      prettyPrintJson: false,
-      onRequest: null,
-      onResponse: null,
-    };
-
-    if (this.options.maxContentLength) {
-      const maxContentLength = this.options.maxUploadFileSize * 1024 * 1024;
-      this.options.maxContentLength = maxContentLength;
-      this.options.maxBodyLength = maxContentLength;
-    }
-
-    this.options = { ...this.options, ...config };
-    this.headers = { ...this.options.defaultHeaders };
-    this.axios = axios.create();
-    this.axios.defaults.headers = this.options.defaultHeaders;
-  }
-
-  static _config() {
-    return [
-      { name: 'endpoint', message: 'Endpoint of API you are going to test', default: 'http://localhost:3000/api' },
-    ];
-  }
-
-  static _checkRequirements() {
-    try {
-      require('axios');
-    } catch (e) {
-      return ['axios'];
-    }
-  }
-
-  _before() {
-    this.headers = { ...this.options.defaultHeaders };
-  }
-
-  /**
-   * Sets request headers for all requests of this test
-   *
-   * @param {object} headers headers list
-   */
-  haveRequestHeaders(headers) {
-    this.headers = { ...this.headers, ...headers };
-  }
-
-  /**
-   * Adds a header for Bearer authentication
-   *
-   * ```js
-   * // we use secret function to hide token from logs
-   * I.amBearerAuthenticated(secret('heregoestoken'))
-   * ```
-   *
-   * @param {string | CodeceptJS.Secret} accessToken  Bearer access token
-   */
-  amBearerAuthenticated(accessToken) {
-    this.haveRequestHeaders({ Authorization: `Bearer ${accessToken}` });
-  }
-
-  /**
-   * Executes axios request
-   *
-   * @param {*} request
-   *
-   * @returns {Promise<*>} response
-   */
-  async _executeRequest(request) {
-    // Add custom headers. They can be set by amBearerAuthenticated() or haveRequestHeaders()
-    request.headers = { ...this.headers, ...request.headers };
-
-    const _debugRequest = { ...request };
-    this.axios.defaults.timeout = request.timeout || this.options.timeout;
-
-    if (this.headers && this.headers.auth) {
-      request.auth = this.headers.auth;
-    }
-
-    if (request.data instanceof Secret) {
-      _debugRequest.data = '*****';
-      request.data = (typeof request.data === 'object' && !(request.data instanceof Secret)) ? { ...request.data.toString() } : request.data.toString();
-    }
-
-    if ((typeof request.data) === 'string') {
-      if (!request.headers || !request.headers['Content-Type']) {
-        request.headers = { ...request.headers, ...{ 'Content-Type': 'application/x-www-form-urlencoded' } };
-      }
-    }
-
-    if (this.config.onRequest) {
-      await this.config.onRequest(request);
-    }
-
-    this.options.prettyPrintJson ? this.debugSection('Request', beautify(JSON.stringify(_debugRequest))) : this.debugSection('Request', JSON.stringify(_debugRequest));
-
-    let response;
-    try {
-      response = await this.axios(request);
-    } catch (err) {
-      if (!err.response) throw err;
-      this.debugSection('Response', `Response error. Status code: ${err.response.status}`);
-      response = err.response;
-    }
-    if (this.config.onResponse) {
-      await this.config.onResponse(response);
-    }
-    this.options.prettyPrintJson ? this.debugSection('Response', beautify(JSON.stringify(response.data))) : this.debugSection('Response', JSON.stringify(response.data));
-    return response;
-  }
-
-  /**
-   * Generates url based on format sent (takes endpoint + url if latter lacks 'http')
-   *
-   * @param {*} url
-   */
-  _url(url) {
-    return /^\w+\:\/\//.test(url) ? url : this.options.endpoint + url;
-  }
-
-  /**
-   * Set timeout for the request
-   *
-   * ```js
-   * I.setRequestTimeout(10000); // In milliseconds
-   * ```
-   *
-   * @param {number} newTimeout - timeout in milliseconds
-   */
-  setRequestTimeout(newTimeout) {
-    this.options.timeout = newTimeout;
-  }
-
-  /**
-   * Send GET request to REST API
-   *
-   * ```js
-   * I.sendGetRequest('/api/users.json');
-   * ```
-   *
-   * @param {*} url
-   * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
-   *
-   * @returns {Promise<*>} response
-   */
-  async sendGetRequest(url, headers = {}) {
-    const request = {
-      baseURL: this._url(url),
-      headers,
-    };
-    return this._executeRequest(request);
-  }
-
-  /**
-   * Sends POST request to API.
-   *
-   * ```js
-   * I.sendPostRequest('/api/users.json', { "email": "user@user.com" });
-   *
-   * // To mask the payload in logs
-   * I.sendPostRequest('/api/users.json', secret({ "email": "user@user.com" }));
-   *
-   * ```
-   *
-   * @param {*} url
-   * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
-   * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
-   *
-   * @returns {Promise<*>} response
-   */
-  async sendPostRequest(url, payload = {}, headers = {}) {
-    const request = {
-      baseURL: this._url(url),
-      method: 'POST',
-      data: payload,
-      headers,
-    };
-
-    if (this.options.maxContentLength) {
-      request.maxContentLength = this.options.maxContentLength;
-      request.maxBodyLength = this.options.maxContentLength;
-    }
-
-    return this._executeRequest(request);
-  }
-
-  /**
-   * Sends PATCH request to API.
-   *
-   * ```js
-   * I.sendPatchRequest('/api/users.json', { "email": "user@user.com" });
-   *
-   * // To mask the payload in logs
-   * I.sendPatchRequest('/api/users.json', secret({ "email": "user@user.com" }));
-   *
-   * ```
-   *
-   * @param {string} url
-   * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
-   * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
-   *
-   * @returns {Promise<*>} response
-   */
-  async sendPatchRequest(url, payload = {}, headers = {}) {
-    const request = {
-      baseURL: this._url(url),
-      method: 'PATCH',
-      data: payload,
-      headers,
-    };
-
-    if (this.options.maxContentLength) {
-      request.maxContentLength = this.options.maxContentLength;
-      request.maxBodyLength = this.options.maxBodyLength;
-    }
-
-    return this._executeRequest(request);
-  }
-
-  /**
-   * Sends PUT request to API.
-   *
-   * ```js
-   * I.sendPutRequest('/api/users.json', { "email": "user@user.com" });
-   *
-   * // To mask the payload in logs
-   * I.sendPutRequest('/api/users.json', secret({ "email": "user@user.com" }));
-   *
-   * ```
-   *
-   * @param {string} url
-   * @param {*} [payload={}] - the payload to be sent. By default it is sent as an empty object
-   * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
-   *
-   * @returns {Promise<*>} response
-   */
-  async sendPutRequest(url, payload = {}, headers = {}) {
-    const request = {
-      baseURL: this._url(url),
-      method: 'PUT',
-      data: payload,
-      headers,
-    };
-
-    if (this.options.maxContentLength) {
-      request.maxContentLength = this.options.maxContentLength;
-      request.maxBodyLength = this.options.maxBodyLength;
-    }
-
-    return this._executeRequest(request);
-  }
-
-  /**
-   * Sends DELETE request to API.
-   *
-   * ```js
-   * I.sendDeleteRequest('/api/users/1');
-   * ```
-   *
-   * @param {*} url
-   * @param {object} [headers={}] - the headers object to be sent. By default it is sent as an empty object
-   *
-   * @returns {Promise<*>} response
-   */
-  async sendDeleteRequest(url, headers = {}) {
-    const request = {
-      baseURL: this._url(url),
-      method: 'DELETE',
-      headers,
-    };
-
-    return this._executeRequest(request);
-  }
-}
-module.exports = REST;

package/docs/build/SeleniumWebdriver.js

@@ -1,76 +0,0 @@
-const Helper = require('../helper');
-
-/**
- * SeleniumWebdriver helper is based on the official [Selenium Webdriver JS](https://www.npmjs.com/package/selenium-webdriver)
- * library. It implements common web api methods (amOnPage, click, see).
- *
- * ## Backends
- *
- * ### Selenium Installation
- *
- * 1. Download [Selenium Server](http://docs.seleniumhq.org/download/)
- * 2. For Chrome browser install [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/getting-started), for Firefox browser install [GeckoDriver](https://github.com/mozilla/geckodriver).
- * 3. Launch the server: `java -jar selenium-server-standalone-3.xx.xxx.jar`. To locate Chromedriver binary use `-Dwebdriver.chrome.driver=./chromedriver` option. For Geckodriver use `-Dwebdriver.gecko.driver=`.
- *
- *
- * ### PhantomJS Installation
- *
- * PhantomJS is a headless alternative to Selenium Server that implements [the WebDriver protocol](https://code.google.com/p/selenium/wiki/JsonWireProtocol).
- * It allows you to run Selenium tests on a server without a GUI installed.
- *
- * 1. Download [PhantomJS](http://phantomjs.org/download.html)
- * 2. Run PhantomJS in WebDriver mode: `phantomjs --webdriver=4444`
- *
- * ## Configuration
- *
- * This helper should be configured in codecept.json or codecept.conf.js
- *
- * * `url` - base url of website to be tested
- * * `browser` - browser in which perform testing
- * * `driver` - which protractor driver to use (local, direct, session, hosted, sauce, browserstack). By default set to 'hosted' which requires selenium server to be started.
- * * `restart` - restart browser between tests (default: true).
- * * `smartWait`: (optional) **enables SmartWait**; wait for additional milliseconds for element to appear. Enable for 5 secs: "smartWait": 5000
- * * `disableScreenshots` (optional, default: false)  - don't save screenshot 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` set to false.
- * * `keepCookies` (optional, default: false)  - keep cookies between tests when `restart` set to false.*
- * * `seleniumAddress` - Selenium address to connect (default: http://localhost:4444/wd/hub)
- * * `waitForTimeout`: (optional) sets default wait time in _ms_ for all `wait*` functions. 1000 by default;
- * * `scriptTimeout`: (optional) sets default timeout for scripts in `executeAsync`. 1000 by default.
- * * `windowSize`: (optional) default window size. Set to `maximize` or a dimension in the format `640x480`.
- * * `manualStart` (optional, default: false) - do not start browser before a test, start it manually inside a helper with `this.helpers["WebDriverIO"]._startBrowser()`
- * * `capabilities`: {} - list of [Desired Capabilities](https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities)
- *
- * Example:
- *
- * ```json
- * {
- *    "helpers": {
- *      "SeleniumWebdriver" : {
- *        "url": "http://localhost",
- *        "browser": "chrome",
- *        "smartWait": 5000,
- *        "restart": false
- *      }
- *    }
- * }
- * ```
- *
- * ## Access From Helpers
- *
- * Receive a WebDriverIO client from a custom helper by accessing `browser` property:
- *
- * ```js
- * this.helpers['SeleniumWebdriver'].browser
- * ```
- *
- */
-class SeleniumWebdriver extends Helper {
-  constructor(config) {
-    console.log('SeleniumWebdriver helper is now alias to Protractor');
-    console.log('Please replace in your config: SeleniumWebdriver -> Protractor');
-    super(config);
-  }
-}
-
-module.exports = SeleniumWebdriver;