further documentation

This commit is contained in:
Felix Böhm 2014-08-29 20:53:58 +02:00
parent c39dfad25a
commit a3639a5c02
1 changed files with 44 additions and 3 deletions

View File

@ -16,7 +16,7 @@ Install the webdriver
./node_modules/protractor/bin/webdriver-manager update
```
Install as global commands ( optional )
Install protractor as global command ( optional )
```
npm install -g protractor
```
@ -25,15 +25,56 @@ 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
* Protractor, [https://github.com/angular/protractor](https://github.com/angular/protractor)
* Jasmine, [https://github.com/pivotal/jasmine](https://github.com/pivotal/jasmine)