nightwatch/lib/api/protocol/window.js

Easy to use Node.js based End-to-End testing solution for browser based apps and websites, using the W3C WebDriver API.

const ProtocolAction = require('./_base-action.js');

/**
 * Change focus to another window or close the current window. Shouldn't normally be used directly, instead `.switchWindow()` and `.closeWindow()` should be used.
 *
 * @link /#switch-to-window
 * @syntax .window(httpMethod, handleOrName, [callback])
 * @param {string} method The HTTP method to use. Can be either `POST` (change focus) or `DELETE` (close window).
 * @param {string} handleOrName The window to change focus to.
 * @param {function} [callback] Optional callback function to be called when the command finishes.
 * @api protocol.window
 */
module.exports = class Action extends ProtocolAction {
  command(method, handleOrName, callback) {
    method = method.toUpperCase();

    switch (method) {
      case 'POST':
        if (arguments.length < 2 || handleOrName === undefined) {
          throw new Error('POST requests to /window must include a name parameter also.');
        }

        return this.transportActions.switchToWindow(handleOrName, callback);

      case 'DELETE':
        return this.transportActions.closeWindow(arguments[1]);

      default:
        throw new Error('.window() method expects first argument to be either POST or DELETE.');
    }
  }
};