As you know the structure of a Confluence app (or any other maven project), there's a pom.xml and a src folder including a main and test package.

Let's have a look at the required files for adding UI tests. For Protractor there have to be added at least two files: package.json and protractorConfig.js

package.json

The package.json is similar to the pom.xml, but for nodejs projects. It provides information about the project and sets up dependent resources like the Confluence Protractor Base or eslint. Furthermore it's the place to add scripts, which can be run via npm run <script-name>. You already know one command from running the UI tests 'test-e2e'

The properties in detail (the important one are bold)

See the complete file on GitHub: https://github.com/seibert-media/random-page/blob/develop/package.json

The UI test itself can be found underneath src/test/ui-test, this is the place for the second required file to run UI tests

protractorConfig.js

This file contains the configuration for the UI tests, it includes required sources, sets up some default values and specifies the test files (so called specs) to be run.

This is the first time, where the Confluence Protractor Base can be seen in action. The local configuration extends some default settings from the CPB.

See the whole file on GitHub: https://github.com/seibert-media/random-page/blob/develop/src/test/ui-tests/protractorConfig.js

The first thing is the import of the Confluence Protractor Base

var confluenceProtractorBase = require('confluence-protractor-base').confluenceProtractorBase;

Then the some default timeouts are set in your project: 

pageObjectUtils.setDefaultElementTimeout(2 * 1000);
pageObjectUtils.setDefaultLoadingTimeout(20 * 1000);

The next block is a bigger one and extends the protractorConfig.js from the Confluence Protractor Base by merging two objects.

Most properties can be left the way way they are in the CPB, simply three proerties are overriden

Recommendation for the specs order

Two common specs should be run before the others: uploadPlugin.spec.js and prepareTestSetup.spec.js. Those files install your plugin and setup some test data

After all tests are done you might want to cleanup all the prepared test data:  cleanupTestSetup.spec.js

All other test cases should be via wildcard (*.spec.js), which means they are executed in random order and therefore should not be dependent on each other! Inside a spec file the test are executed in order of appearance.

Take away

Simply two files are needed to setup and configure the UI tests, the required files can be taken as provided from the Random Page app with only small adjustments.

Navigation

< Part 1: First Steps | Part 3: Common Spec Files >