Readonly Test Field

It is possible to find readonlyTextInput element by following attributes:

Name	Parameter(s)	Type	Description
readonlyTextInput	dataTestId	string	Searches for a readonly text field by value of a Pega data-test-id attribute, same as readonlyTextInputByDataTestId
readonlyTextInputByDataTestId	dataTestId	string	Searches for a readonly text field by value of a Pega data-test-id attribute, same as readonlyTextInput
readonlyTextInputById	id	string	Searches for a readonly text field by value of an id attribute
readonlyTextInputBy	attributeName	string	Searches for a readonly text field by an attribute name and value
	attributeValue	string

Assertions

Assertions include many methods for filtering by index because readonly text fields quite often have the same data-test-ids, and it's difficult to differentiate them.

Name	Parameter(s)	Type	Description
shouldBeVisible	options?	{ index?: number, timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element exists and visible
shouldBeVisibleByIndex	index	number	Checks if the element exists and visible by a given index
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldExist	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element exists
shouldNotBeVisible	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element exists but is not visible
shouldNotBeVisibleByIndex	index	number	Checks if the element exists but is not visible by a given index
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotExist	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element does not exist
shouldHaveText	value	string	Checks if the element's inner text contains a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldHaveTextByIndex	value	string	Checks if the element's inner text by a given index contains a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveText	value	string	Checks if the element's inner text does not contain a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveTextByIndex	value	string	Checks if the element's inner text by a given index does not contain a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldHaveExactText	value	string	Checks if the element's inner text is equal to a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldHaveExactTextByIndex	value	string	Checks if the element's inner text by a given index is equal to a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveExactText	value	string	Checks if the element's inner text is not equal to a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveExactTextByIndex	value	string	Checks if the element's inner text by a given index is not equal to a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldHaveValue	value	string	Checks if the element's value contains a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldHaveValueByIndex	value	string	Checks if the element's value by a given index contains a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveValue	value	string	Checks if the element's value does not contain a given string
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveValueByIndex	value	string	Checks if the element's value by a given index does not contain a given string
	index	number
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldBeEnabled	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element doesn't have a disabled attribute
shouldBeDisabled	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element has a disabled attribute
shouldNotBeBlank	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the element's inner text is not equal to an empty string ("")
shouldNotBeBlankByIndex	index	number	Checks if the element's inner text by a given index is not equal to an empty string ("")
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldBeRequired	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the field is mandatory
shouldNotBeRequired	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }	Checks if the field is not mandatory
shouldHaveValidationType	validationType	string	Checks if the element's validation type is equal to a given one
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }
shouldNotHaveValidationType	validationType	string	Checks if the element's validation type is not equal to a given one
	options?	{ timeout?: number, assertionTimeout?: number, interval?: number, retries?: number }

Wait for functions

Simple wait for visibility functions

Name	Parameter(s)	Type	Description
waitUntilVisibility	options?	{ timeout?: number, interval?: number, retries?: number }	Waits for the element to be visible
waitUntilInvisibility	options?	{ timeout?: number, interval?: number, retries?: number }	Waits for the element to be invisible
waitUntilElementExists	options?	{ timeout?: number, interval?: number, retries?: number }	Waits for the element to exist
waitUntilElementNotExist	options?	{ timeout?: number, interval?: number, retries?: number }	Waits for the element not to exist

Complex wait for visibility functions

Allow filtering of available elements by index, text, attribute:

Name	Parameter(s)	Type	Description
waitUntilVisibilityByText	text	string	Filters collection of elements by text and waits for the element to be visible
	options?	{ timeout?: number, interval?: number, retries?: number }
waitUntilVisibilityByAttribute	attributeName	string	Filters collection of elements by attribute and waits for the element to be visible
	attributeValue	string
	options?	{ timeout?: number, interval?: number, retries?: number }
waitUntilVisibilityByIndex	index	number	Filters collection of elements by index and waits for the element to be visible
	options?	{ timeout?: number, interval?: number, retries?: number }
waitUntilInvisibilityByIndex	index	number	Filters collection of elements by index and waits for the element not to be visible
	options?	{ timeout?: number, interval?: number, retries?: number }

Wait for a collection size functions

Name	Parameter(s)	Type	Description
waitUntilCollectionOfElementsSizeIsGreaterOrEqual	expectedSize	number	Waits until collection of elements have specific size (or there are more)
	options?	{ timeout?: number, interval?: number, retries?: number }
waitUntilCollectionOfElementsSizeIsLessThan	expectedSize	number	Waits until collection of elements have fewer elements than specified
	options?	{ timeout?: number, interval?: number, retries?: number }

Actionability check

ActionabilityCheckTypes == attached | stable | visible | enabled | editable

Name	Parameter(s)	Type	Description
waitForSelectActionabilityCheck	check types	[]	Waits for the element to pass all the selected actionability check types
	isFilterByVisibility	boolean (true by default)

e.g.

await pega.readonlyTextInput('firstName').waitForSelectActionabilityCheck(['attached', 'visible', 'stable']);

IsVisible and IsExists functions

Name	Parameter(s)	Type	Description
isVisible	options?	{ timeout?: number, interval?: number, retries?: number }	Returns true if the element exists and is visible
isExists	options?	{ timeout?: number, interval?: number, retries?: number }	Returns true if the element exists

GetValue and GetText functions

Name	Parameter(s)	Type	Description
getValue			Returns element's value as a string
getText			Returns element's inner text as a string