Welcome to the WebDriver.io Boilerplate project! This is meant to be a simple easy to understand project to get anyone started with Webdriver.io and Mocha BDD. This project also supports ES6, via Babel and uses the Page Object design pattern.
- Make sure you have NodeJS
12.18.1or higher installed. - Make sure you have JDK 1.8 or higher.
Clone this project into a new directory and then navigate into the cloned directory.
npm install
Install the chrome and gecko drivers with the following command:
./scripts/install-chromedriver.sh
To run the tests available in the boilerplate, all you need to do is run: npm test
This will run tests against the the internet.
This application also has an example Dockerfile. Many times when developing tests for customers, they will want to be able to run them in their CI environment. This Dockerfile will build a docker image based on Docker Selenium Chrome standalone.
The docker process is broken out into two parts, the base image and the runner image. The base image installs all the node dependencies and packages, as well as installs selenium-standalone. The runner image only installs the updates tests, pages objects and configs. This is to eliminate the need to install anything at test run time, preventing install dependancies from becoming unavailable.
This is a portable docker image that can run anywhere a Docker image can be run. However, in order to have tests actually be able to run from the docker container, they'll need to be run in headless mode.
In the config/wdio.conf.js file at line 59 is a commented out Google Chrome options for running in headless mode. Un-comment out those lines and you're ready to run in headless mode.
Update ./scripts/image_names.sh script to the name the Docker images something more appropriate to what you want.