]> source.dussan.org Git - nextcloud-server.git/commitdiff
further documentation
authorFelix Böhm <felixboehm@gmx.de>
Fri, 29 Aug 2014 18:53:58 +0000 (20:53 +0200)
committerFelix Böhm <felixboehm@gmx.de>
Fri, 29 Aug 2014 18:53:58 +0000 (20:53 +0200)
tests/acceptance/readme.md

index 7fcc791da01b9049b3f26bfe4d05a4076acba7ec..625036a9e4ad33c0a3b229a113ac252364983e61 100644 (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)
+