Safe Haskell	None
Language	Haskell98

Test.WebDriver.Commands.Angular

Contents

Loading
Searching for elements
Misc

Description

This module exposes webdriver actions that can be used to interact with a page which uses AngularJs. This provides similar functionality as protractor and in fact we share some code with protractor.

Synopsis

Loading

waitForAngular #

Arguments

:: (MonadIO wd, WebDriver wd)
=> Text	CSS selector to element which has ng-app
-> wd Bool

Wait until Angular has finished rendering before continuing. False indicates the timeout was hit (see setScriptTimeout) and we stopped waiting and True means that angular has finished rendering.

Searching for elements

data NgException #

Exceptions of this type will be thrown when an element is unable to be located.

Constructors

NgException String

Instances

Eq NgException #
Methods (==) :: NgException -> NgException -> Bool # (/=) :: NgException -> NgException -> Bool #
Show NgException #
Methods showsPrec :: Int -> NgException -> ShowS # show :: NgException -> String # showList :: [NgException] -> ShowS #
Exception NgException #
Methods toException :: NgException -> SomeException # fromException :: SomeException -> Maybe NgException # displayException :: NgException -> String #

data NgSelector #

Constructors

ByBinding Text	Argument is the binding, e.g. {{dog.name}}
ByModel Text	Argument is the model name. Searches for elements with the `ng-model="name"` attribute.
BySelectedOption Text	Argument is a model name. Searches for selected options within a select element matching the modelname. That is, the `<option:checked>` elements within a `<select ng-model="name" ... >`.

Instances

Eq NgSelector #
Methods (==) :: NgSelector -> NgSelector -> Bool # (/=) :: NgSelector -> NgSelector -> Bool #
Show NgSelector #
Methods showsPrec :: Int -> NgSelector -> ShowS # show :: NgSelector -> String # showList :: [NgSelector] -> ShowS #

findNg :: (MonadIO wd, WebDriver wd) => NgSelector -> wd Element #

Find a single element from the document matching the given Angular selector. If zero or more than one element is returned, an exception of type NgException is thrown.

findNgs :: WebDriver wd => NgSelector -> wd [Element] #

Find elements from the document matching the given Angular selector.

findNgFrom :: (MonadIO wd, WebDriver wd) => Element -> NgSelector -> wd Element #

Find a single element from within the given element which matches the given Angular selector. If zero or more than one element is returned, an exception of type NgException is thrown.

findNgsFrom :: WebDriver wd => Element -> NgSelector -> wd [Element] #

Find elements from within the given element which match the given Angular selector.

data NgRepeater #

Constructors

ByRows Text	All the rows matching the repeater (e.g. 'dog in dogs')
ByRow Text Int	A single row specified by the text of the repeater (e.g. 'dog in dogs') and the row index
ByColumn Text Text	A single column matching the text of the repeater (e.g. 'dog in dogs') and the column binding (e.g '{{dog.name}}').
ByRowAndCol Text Int Text	A single row and column, given (repeater, row index, column binding).

Instances

Eq NgRepeater #
Methods (==) :: NgRepeater -> NgRepeater -> Bool # (/=) :: NgRepeater -> NgRepeater -> Bool #
Show NgRepeater #
Methods showsPrec :: Int -> NgRepeater -> ShowS # show :: NgRepeater -> String # showList :: [NgRepeater] -> ShowS #

findRepeaters :: WebDriver wd => NgRepeater -> wd [Element] #

Finds elements from the document which match the NgRepeater.

Note that when using ng-repeat-start and ng-repeat-end and looking up using ByRows, all elements are returned in one big list, not grouped by each instance of ng-repeat-start.

findRepeater :: (MonadIO wd, WebDriver wd) => NgRepeater -> wd Element #

A variant on findRepeaters which throws an exception if the return value from findRepeaters does not have length exactly one.

findRepeaterFrom :: (MonadIO wd, WebDriver wd) => Element -> NgRepeater -> wd Element #

A variant of findRepater which allows searching only the given element.

findRepeatersFrom :: WebDriver wd => Element -> NgRepeater -> wd [Element] #

A variant of findRepaters which allows searching only the given element.

Misc

ngEvaluate #

Arguments

:: (WebDriver wd, FromJSON a)
=> Element	element in whose scope to evaluate
-> Text	expression to evaluate, e.g. "dog.name \| reverse"
-> wd a

Evaluate an angular expression, using the scope attached to the given element.

getLocationAbsUrl #

Arguments

:: WebDriver wd
=> Text	CSS selector to element which has ng-app
-> wd Text

Return the current absolute url according to Angular (using $location.absUrl()).

setNgLocation #

Arguments

:: (MonadIO wd, WebDriver wd)
=> Text	CSS selector to the element which has ng-app
-> Text	URL
-> wd ()

Browse to another page using in-page navigation (via $location.url).