Selenium/How-to/Run tests targeting MediaWiki-Vagrant

For this example, we will not enable any roles and we will use MediaWiki core.

Advantages

Running Selenium tests targeting MediaWiki-Vagrant machine has several advantages:

• It will be fast, since the target machine is local. MediaWiki core Selenium test run takes about 2 minutes on my machine. (As of September 2019.)
• After everything is set up, you do not need internet connection.
• Debugging failed tests will be easier, since are able to see the browser using DISPLAY environment variable. See README.md for more information.
• You are probably already familiar with MediaWiki-Vagrant and have it installed.

Disadvantages

• You might not be familiar with MediaWiki-Vagrant, so you will have to learn how to install and use yet another tool.
• You will have to install Vagrant, MediaWiki-Vagrant and their dependencies on your machine.
• You will be executing over 900 JavaScript packages (as of August 2019) directly on your machine with access to all personal/work files.

Set up MediaWiki-Vagrant

• Follow instructions at MediaWiki-Vagrant.

Boot the machine

$ vagrant up

Go to mediawiki folder

$ cd mediawiki

Install dependencies

Depending on your operating system, installing dependencies will be different.

Chrome

• Install Chrome.
• Download ChromeDriver and put it in a folder included in PATH.

Node.js

• Install Node.js.
• Install required npm packages.

$ npm ci

Run Selenium tests

npm run selenium

suspend or halt the machine

$ vagrant suspend
==> default: Saving VM state and suspending execution...

or

$ vagrant halt
==> default: Attempting graceful shutdown of VM...