Test.WebDriver.Commands.Angular

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.

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).