Keywords

* elementCount
* getVersionNumbers
* hideElement
* screenSize
* setCheckbox
* setDropdown

elementCount

$3

Read the number of elements that match a certain criteria

$3

* The ``elementCount(locateStrategy, selector, count)` keyword has three required parameters:
* `locateStrategy` - can be something like `css selector` or `xpath` and is based on the selector
* `selector` - is way in which we identify the element
* `count` - is the number of items that we are expecting there to be

$3

It checks the number of elements which match the selector and if it does not match the count given then it will fail the assertion.

$3

`
browser.page..assert.elementCount('css selector', 'ol li', 7);
`

getVersionNumbers

$3

This extracts the version number of a product from the HTML source

$3

The `getVersionNumber(['name'])` keyword accepts an array of names.

$3

It reads in the HTML source of a page and then parses it to look for the `name` which is of the format `name/xx.yy.zz`. Where `xx.yy.zz` are the version numbers.

$3

`
browser.page..getVersionNumbers(['name']);
`

hideElement

$3

This can hide an element from the page and is useful for when performing screen comparisons and ignoring certain sections of the page

$3

The `hideElement(elementId)` keyword accepts an element ID.

$3

It edits the styling of the HTML in question to turn the opacity to full, so it is transparent.

$3

`
browser.page..hideElement(elementId);
`

screenSize

$3

This provides a way of us getting the width of the browser window so we can vary the assertions in a test accordingly. For example the layout of modules is different at different screen widths.

The nightwatch supported way for getting the screen width does not work on Firefox, or the iPhone. This function provides an alternate way of doing this.

$3

It runs some javascript in the browser which returns the width of the browser window, and returns it in the callback.

$3

`
browser.screenSize(function (screenSize) {
if (screenSize >= 600) {
// verify something on a large screen
} else {
// verify something on a small screen
}
});
`

setCheckbox

$3

This provides a way of setting a checkbox to either true/false regardless of it's current state

$3

* The `setCheckbox(locateStrategy, selector, value)` keyword has three required parameters:
* `locateStrategy` - can be something like `css selector` or `xpath` and is based on the selector
* `selector` - is way in which we identify the element
* `value` - this can either be `true` or `false` depending on whether we want it checked or not

$3

It checks the current value of the checkbox and if it does not match the value given then it will change it to be the correct value, however if it is the correct value then it will carry on without changing anything.

$3

`
browser.page.object.setCheckbox('css selector', '', true)
`

setDropdown

$3

This provides a way of setting a select dropdown option

$3

* The `setDropdown(selector, value)` keyword has two required parameters:
* `selector` - is way in which we identify the element
* `value` - is the value which is provided inside the ``

$3

It clicks the dropdown menu to show the options and then selects the appropriate value

$3

`
browser.page.object.setDropdown('bodyColor', '#77BC30')
``