loadero-nightwatch-commands v1.1.0

loadero-nightwatch-commands

Installation

Installation is as simple as running the following npm command:

npm install --save loadero-nightwatch-commands

Make sure you run it in the directory where your package.json file is located. The command shown above will also add the dependency to your package.json file. It can also be added manually in dependencies object as loadero-nightwatch-commands.

The latest tag will always be the most up-to-date version when compared to the commands used in Loadero environment.

Usage

These Nightwatch custom commands were made to simplify local script development for usage in Loadero environment. By using these commands, you can write your Loadero script locally and then upload it to Loadero. This also allows for more rapid development because the script can be debugged and run locally.

To use the commands in your tests, you need to add this package as a plugin to your Nightwatch configuration file. For example, if your project has a nightwatch.conf.js file, you need to add the following line to it:

plugins: ["loadero-nightwatch-commands"]

After that, all you have to do then is run npm install after which you will be able to use the commands in your tests. For example:

client => {
    const reallyLongPause = 5 * 60 * 1000; // 5 minutes

    client
        // Example of timing execution without specifying a timeout.
        .url("https://duckduckgo.com/")
        .timeExecution("locate_search_bar", () => {
            client
                .waitForElementVisible("#searchbox_input", 10 * 1000)
                .sendKeys("#searchbox_input", "QA Processes")
                .click("[aria-label='Search']")
                .waitForElementVisible("#r1-0 > div > h2", 10 * 1000)
                .pause(reallyLongPause);
        })
        .takeScreenshot("screenshot.png");
}

NOTE: In place of client you should use the argument that describes the nightwatch client in your test. By default Loadero creates the template using client. A lot of times client is also referred to as browser.

Not all commands behave the same way as they do in the Loadero environment. Some of them are modified to work in a local environment, such as updateNetwork and setRequestHeader.

Commands

The following table shows all available commands and whether there are any changes to how they function in a local environment.

Full descriptions for how each function behaves in Loadero and their usage can be found in Loadero wiki page. To see the differences between local and Loadero environment, you can compare the descriptions in the wiki to the differences mentioned in this README.

The emails.json file should be located in the same directory where package.json file is located in your project and should have the following structure:

{
  "emails": [
    {
      "from": "email_from",
      "to": "email_to",
      "headers": {
        "header1": "header_value"
      },
      "subject": "email_subject",
      "text/html": "html body",
      "text/plain": "plain text body"
    }
  ]
}

To simulate a more realistic environment, you can modify the emails.json file mid-run to add additional emails to the array. The file will be read every time the receiveEmail command is called.