AngularJSLibrary - robotframework-angularjs
An AngularJS extension to Robotframework's Selenium2Library
What is included
AngularJSLibrary provides keywords for finding elements by binding, model, and repeater. The library also provides a keyword for waiting on angular.
Installation
To install AngularJSLibrary, run:
pip install robotframework-angularjs
Alternatively, to install from source:
python setup.py install
Keyword Usage
In order to use the keywords you have to include AngularJSLibrary in the settings section of your test. Note will will need to include the Selenium2Library before you import the AngularJSLibrary.
*** Settings ***
Library Selenium2Library
Library AngularJSLibrary
...
*** Test Cases ***
Go To localhost:8080
Wait for Angular
...
The new locator strategies include
binding= model= repeater=
For example, you can look for an Angular ng-binding using
Get Text binding={{greeting}}
or by using partial match
Get Text binding=greet
or by simply using the binding {{…}} notation
Get Text {{greeting}}
One can also find elements by model
Input Text model=aboutbox Something else to write about
Finally there is the strategy of find by repeat. This takes the general form of repeater=some ngRepeat directive@row[n]@column={{ngBinding}}
. Here we specify the directive as well as the row, an zero-based index, and the column, an ngBinding. Using this full format will return, if exists the element matching the directive, row and column binding. One does not need to specify the row and column but can specify either both, one or the other or neither. In such cases the locator may return list of elements or even a list of list of elements. Also the ordering of row and column does not matter; using repeater=baz in days@row[0]@column=b
is the same as repeater=baz in days@column=b @row[0]
.
Getting Help
If you need help with AngularJSLibrary, Selenium2Library, or Robot Framework usage, please post to the user group for Robot Framework.
Testing
For information on how we test the AngularJSLibrary see the `Testing.rst`_ file.
References
Selenium2Library: Web testing library for Robot Framework
Protractor: E2E test framework for Angular apps