Confluence Protractor Base
Automated UI Tests for Confluence
The Confluence Protractor Base is a simple solution to implement und run UI tests for Atlassian Confluence. It provides basic functionality like creating pages, spaces, users and groups as well as login, authenticate as admin and open pages.
Download the Confluence Protractor Base at npmjs
Installation
>> npm install confluence-protractor-base
First Steps
- Start a local Confluence instance
- Checkout the project and switch to the directory
- Install requirements
npm install - Update webdriver manager
npm run webdriver-update - Start the webdriver manager
npm run webdriver-start - run UI tests in another console window (e2e means End-to-End)
npm run test-e2e
Local Confluence instance
First of all you need a local Confluence instance.
The instance should be locally available under http://localhost:1990/confluence (Atlassian® SDK standard)
This can be done via the Atlassian SDK or with a Docker container
Atlassian SDK
Start a local Confluence test instance using the Atlassian® SDK
atlas-run-standalone --product confluence
Docker container
Start a local Confluence® docker instance\
Supported Platforms
We have tested the confluence-protractor-base with
- Confluence 5.7 - 6.7
- PSQL, MYSQL, MSSQL
Troubleshooting
See Issues
Known issues
Page edit with synchrony (concurrent editing)
Page edit with synchrony enabled may be unstable. All page objects inheriting from ConfluenceBase have adisableSynchrony() method to prevent problems. Example:
const upm = new UniversalPluginManager(); upm.disableSynchrony();