nextcloud/tests/acceptance
Felix Böhm a3639a5c02 further documentation 2014-08-29 20:53:58 +02:00
..
screenshots add bunch of acceptance tests 2014-08-29 12:26:30 +02:00
tests fix login suite 2014-08-29 19:56:54 +02:00
.gitignore gitignore for node modules 2014-08-29 12:36:23 +02:00
package.json bump version of protractor in package.json 2014-08-29 19:56:54 +02:00
protractor_conf.js add bunch of acceptance tests 2014-08-29 12:26:30 +02:00
readme.md further documentation 2014-08-29 20:53:58 +02:00

readme.md

ownCloud Acceptance Tests

Setup

Install node.js and run the following to install the dependencies

npm install

Install the webdriver

./node_modules/protractor/bin/webdriver-manager update

Install protractor as global command ( optional )

npm install -g protractor

Run

Run the tests with protractor

protractor protractor.conf.js

Run only a specific test suite or spec

protractor protractor.conf.js --suite install
protractor protractor_conf.js --params.baseUrl="http://127.0.0.1/ownClouds/test-community-7.0.1/" --suite=login
protractor protractor_conf.js --params.baseUrl="http://127.0.0.1/ownClouds/test-community-7.0.1/" --specs tests/login/newUser_spec.js

More Test Suits

You can find and define suites in protractor_conf.js

Install suite: Run this suite on a not yet installed ownCloud, it will install during the tests

After installation tests should run without the "First Run Wizard" app because of timing issues. Disable the app on the server with

php occ app:disable firstrunwizard

Page Objects

The tests/pages folder contains page objects. A page object describes a webpage, gathers selectors and provides functions for actions on the page.

In the specs these higher level functionality can be reused and the tests become nice and readable.

Development

A good starting point is the login suite in the login folder and the login page object.

If you want to start only a single test (it) or collection of tests (describe) use:

  • iit to run a single test
  • ddescribe to run only this collection

You can also use

  • xit to exclude this test
  • xdescribe to exclude this collection

For deeper insights and api docs have a look at