Run Nightwatch tests on CircleCI
In this article, you will learn how to create and run Nightwatch tests on CircleCI
CircleCI is a CI/CD platform that can be used to create an automated testing pipeline. CircleCI can be used to execute tests on the same instances or on cloud-service providers such as BrowserStack & Sauce Labs.
- CircleCI account
- Nightwatch project uploaded to Git
We will be taking the nightwatch-examples repo for demonstration. Now, let's configure CI by following the procedures below :
Step 1: Setup CircleCI Project
Once you connect your CircleCI account to Github and you click on "Projects" in the left menu, you will see the list of repositories from Github.
Click on "Setup Project" besides your test repository
Config.yml dialog opens, select the option "Take me to a config.yml template that I can edit" as shown below
In the next screen, select
Node from the list
Step 2 : Update the config.yml file, commit and run the pipeline
Now you will view the config.yml file that you can edit. Copy the below file contents into the file
# This config is equivalent to both the '.circleci/extended/orb-free.yml' and the base '.circleci/config.yml' version: 2.1 # Orbs are reusable packages of CircleCI configuration that you may share across projects, enabling you to create encapsulated, parameterized commands, jobs, and executors that can be used across multiple projects. # See: https://circleci.com/docs/2.0/orb-intro/ orbs: node: email@example.com browser-tools: firstname.lastname@example.org jobs: test: docker: - image: cimg/node:lts-browsers steps: - checkout - browser-tools/install-browser-tools - node/install-packages - run: command: npm run test - store_test_results: path: /tests_output workflows: e2e-test: jobs: - test
Once you have copied the config.yml file, press on
Commit and Run
Let's try to understand the key highlights of the config file: -
- We are using 2 orbs, Node & Browser tools, that are required for the Nightwatch setup
- We are using a docker image that has browsers pre-installed
- Under steps, we are checking out the branch followed by installing the browser tools
- In the next step, all packages from package.json are installed that includes
Nightwatch, driver packages and other required packages
- Once the setup is done, the pipeline will trigger the tests
Step 3 : View the results
Click on the pipeline build that just ran followed by the job name i.e.
test. Under the
Steps tab refer to the
npm run test step to view the test output.