assert

Description

Asserts that a given value meets a condition. That value can be, for an instance, element text, element attribute, element status or current address. The results of the assertion evaulation will be returned in the response extractions. When asserting on elements state, this action will wait for the expected state until ElementSearchingTimout reached.

Scope

Web, Mobile Web, Mobile Native or any other Web Driver implementation.

Properties

Property	Description
actions	The sub set actions to execute when condition is met.
argument	Plugin conditions and additional information.
onAttribute	The element attribute from which to extract information for action execution. If not specified, information will be taken from the element inner text.
onElement	The locator value by which the element will be found.
locator	The locator type by which the element will be found.
regularExpression	A pattern by which the extracted information will be evaluated. Returns the first match.

Command Line Arguments (CLI)

attribute

Return true if the ActionRule.OnAttribute value meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The attribute value and the provided value (expected) are equal.
ne	The attribute value and the provided value (expected) are not equal.
match	The attribute value matches to the provided value.
not_match	The attribute value does not match to the provided value.
gt	Applies for numbers only: The attribute value is greater than provided value (expected).
lt	Applies for numbers only: The attribute value is lower than provided value (expected).
ge	Applies for numbers only: The attribute value is greater or equal to the provided value (expected).
le	Applies for numbers only: The attribute value is lower or equal to the provided value (expected).

count

Return true if the ActionRule.OnElement count (total elements found by the locator) meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The actual count and the provided value (expected) are equal.
ne	The actual count and the provided value (expected) are not equal.
match	The actual count matches to the provided value.
not_match	The actual count does not match to the provided value.
gt	Applies for numbers only: The actual count is greater than provided value (expected).
lt	Applies for numbers only: The actual count is lower than provided value (expected).
ge	Applies for numbers only: The actual count is greater or equal to the provided value (expected).
le	Applies for numbers only: The actual count is lower or equal to the provided value (expected).

disabled

Return true if the element exists in the DOM and it is not enabled.

driver

Return true if the IWebDriver.FullName value meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The driver full name value and the provided value (expected) are equal.
ne	The driver full name value and the provided value (expected) are not equal.
match	The driver full name value matches to the provided value.
not_match	The driver full name value does not match to the provided value.
gt	Applies for numbers only: The driver full name value is greater than provided value (expected).
lt	Applies for numbers only: The driver full name value is lower than provided value (expected).
ge	Applies for numbers only: The driver full name value is greater or equal to the provided value (expected).
le	Applies for numbers only: The driver full name value is lower or equal to the provided value (expected).

enabled

Return true if the element exists in the DOM and it is enabled.

exists

Return true if the element exists in the DOM.

hidden

Return true if the element exists in the DOM and it is not visible.

not_exists

Return true if the element does not exists in the DOM.

parameter

Return true if the AutomationContext.ApplicationParamter value meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The actual count and the provided value (expected) are equal.
ne	The actual count and the provided value (expected) are not equal.
match	The actual count matches to the provided value.
not_match	The actual count does not match to the provided value.
gt	Applies for numbers only: The actual count is greater than provided value (expected).
lt	Applies for numbers only: The actual count is lower than provided value (expected).
ge	Applies for numbers only: The actual count is greater or equal to the provided value (expected).
le	Applies for numbers only: The actual count is lower or equal to the provided value (expected).

selected

Return true if the element exists in the DOM and it is selected.

stale

Return true if the element is stale (element reference out dated or broken).

text

Return true if the ActionRule.OnElement inner text meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The text value and the provided value (expected) are equal.
ne	The text value and the provided value (expected) are not equal.
match	The text value matches to the provided value.
not_match	The text value does not match to the provided value.
gt	Applies for numbers only: The text value is greater than provided value (expected).
lt	Applies for numbers only: The text value is lower than provided value (expected).
ge	Applies for numbers only: The text value is greater or equal to the provided value (expected).
le	Applies for numbers only: The text value is lower or equal to the provided value (expected).

title

Return true if the IWebDriver.Title value meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The title and the provided value (expected) are equal.
ne	The title and the provided value (expected) are not equal.
match	The title matches to the provided value.
not_match	The title does not match to the provided value.
gt	Applies for numbers only: The title is greater than provided value (expected).
lt	Applies for numbers only: The title is lower than provided value (expected).
ge	Applies for numbers only: The title is greater or equal to the provided value (expected).
le	Applies for numbers only: The title is lower or equal to the provided value (expected).

url

Return true if the IWebDriver.Url value meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The URL and the provided value (expected) are equal.
ne	The URL and the provided value (expected) are not equal.
match	The URL matches to the provided value.
not_match	The URL does not match to the provided value.
gt	Applies for numbers only: The URL is greater than provided value (expected).
lt	Applies for numbers only: The URL is lower than provided value (expected).
ge	Applies for numbers only: The URL is greater or equal to the provided value (expected).
le	Applies for numbers only: The URL is lower or equal to the provided value (expected).

visible

Return true if the element is stale (element reference out dated or broken).

windows_count

Return true if the IWebDriver.WindowHandles count (total open tabs/windows) meets a condition. The text based conditions are case sensitive.

Value	Description
eq	The actual count and the provided value (expected) are equal.
ne	The actual count and the provided value (expected) are not equal.
match	The actual count matches to the provided value.
not_match	The actual count does not match to the provided value.
gt	Applies for numbers only: The actual count is greater than provided value (expected).
lt	Applies for numbers only: The actual count is lower than provided value (expected).
ge	Applies for numbers only: The actual count is greater or equal to the provided value (expected).
le	Applies for numbers only: The actual count is lower or equal to the provided value (expected).

W3C Web Driver Protocol

None