Working with checks
In TestArchitect, a check compares and verifies expected behavior against actual observed behavior during a test. It’s good practice to incorporate checks in test procedures to verify that the procedures are running as expected.
Currently, TestArchitect has multiple check actions that can be used to perform verifications of various types. For example:
- If you expect a window to be launched in response to a user action, such as clicking on a button, you may wish to check for the presence of that window after the button is clicked.
- When testing a web page, you may need to check the text value in the browser’s status bar against an expected value.
Built-in check actions list
The following is a full list of check actions – that is, actions whose outcomes are the registration of a Passed or Failed result – along with links to their respective reference pages:
Action | Description | See also |
---|---|---|
check | Check the displayed text in a control against an expected string value; in the base of Boolean-state controls, check the current state against an expected Boolean value. | Text-display checks |
check button menu exists | Check for the existence of a menu item of a button drop-down. | Existence checks |
check button menu not exists | Check for the nonexistence of a specific menu item on a drop-down button . | Existence checks |
check clipboard | Check the text content of the test system’s clipboard against an expected value. | System checks |
check column header name | Check the header value of a column against an expected value. | Text-display checks |
check context menu item exists | Check for the existence of an item on a context menu. | Existence checks |
check context menu item not exists | Check for the nonexistence of an item on a context menu. | Existence checks |
check context menu item state | Validate the current state(s) of a given menu item on a context menu. | Property checks |
check controls matched | Check that all defined controls in an interface entity match the controls in a window of the AUT. | |
check control exists | Check for the existence of a control. | Existence checks |
check control not exists | Check for the nonexistence of a control. | Existence checks |
check control property | Capture the value of a specified property from a control, then compare it against an expected value. | Property checks |
check control tooltip | Capture the tooltip text of a control and compare it against an expected string. | Text-display checks |
check displayed text | Check the text in a control against an expected text string. | Text-display checks |
check file exists | Check for the existence of a specified file. | System checks |
check file not exists | Check for the nonexistence of a specified file. | System checks |
check folder exists | Check for the existence of a specified folder. | System checks |
check folder not exists | Check for the nonexistence of a specified folder. | System checks |
check item exists | Check for the existence of a specified item in a list box, list view, or combo box control. | Existence checks |
check item not exists | Check for the nonexistence of a specified item in a list box, list view, or combo box control list box. | Existence checks |
check listbox checked | Check the state of a check box item in a list box control. | Status checks |
check list cell value | Check the text content of a cell in a list view against an expected value. | Text-display checks |
check list item order | Check for the presence of a specified sequence of items in a control. | Status checks |
check list order | Check that all the items of a control are sorted in either ascending or descending order. | Status checks |
check menu item exists | Check for the existence of an item on a menu. | Existence checks |
check native property | Check the value of a native property of a control against an expected value. | Property checks |
check pattern | Check whether a string of text conforms to a specified pattern. | Get actions |
check pattern in text | Check whether the displayed text of a control contains a specified substring, or matches a specified regular expression. | Get actions |
check pattern not in text | Check whether the displayed text of a control contains a specified substring, or matches a specified regular expression. | Get actions |
check picker view component item count | Check the number of items in a component of a picker view control against an expected value. | Status checks |
check picker view item exists | Check, based on the displayed text content, for the existence of an item in a component of a picker view control. | Existence checks |
check picker view item not exists | Check, based on the displayed text content, for the nonexistence of an item in a component of a picker view control. | Existence checks |
check picture | Check a bitmap area of the AUT’s current display against one or more stored baseline images. Result is Passed ifthe displayed image matches one of the baselines; otherwise Failed. | Image checks |
check picture exists | Check a bitmap area of the AUT’s current display for the presence of a given instance of a specified target image. | Image checks |
check picture not exists | Check a bitmap area of the AUT’s current display for the presence of a given instance of a specified target image. | Image checks |
check process not running | Check that a specified process is not running on a mobile device. | System checks |
check process running | Check that a specified process is running on a mobile device. | System checks |
check row item | Check the contents of a row in a table. | Text-display checks |
check scrollbar exists | Check for the existence of a scroll bar in a control. | Existence checks |
check scrollbar not exists | Check for the nonexistence of a scroll bar in a control. | Existence checks |
check selected count | Check the number of the selected items in a multiple selection control (list box or list view) against an expected count. | Status checks |
check selected items | Check the selection status of specified items in a multiple selection control. | Status checks |
check selected picker view item | Check whether the display text of the currently selected item of a specified picker view component matches an expected text string. | Text-display checks |
check status bar section state | Check the state of a status bar section against an expected value. | Status checks |
check status bar section value | Check the caption of a specified section of the status bar against an expected value. | Text-display checks |
check status bar value | Check the text content of the first panel of a browser’s status bar against an expected value. | Status checks |
check table cell value | Check the text content of a table cell against an expected value. | Text-display checks |
check table view cell exists | Check for the existence of a specified table view cell. | Existence checks |
check table view cell not exists | Check for the nonexistence of a specified table view cell. | Existence checks |
check table view cell value | Check the contents of a table view cell against an expected text string. | Text-display checks |
check table view section exists | Check for the existence of a table view section as identified by its header text. | Existence checks |
check tab exists | Check for the existence of a tab item (a single tab in a tab bar) as identified by its caption. | Existence checks |
check tab not exists | Check for the nonexistence of a tab item (a single tab in a tab bar) as identified by its caption. | Existence checks |
check tab order | Check the tab order* of several controls residing in a specified window. | Status checks |
check text contains | Check for the existence of a specified string of text within another string. | Get actions |
check text exists | Check for the existence of a given bitmap text fragment within a specified area of a bitmap. | Optical Character Recognition checks |
check text line | Check a specified line of multi-line text content against a text string or regular expression. | Get actions |
check text not contains | Check the nonexistence of a specified string within another string. | Get actions |
check text not exists | Check for the nonexistence of a given bitmap text fragment in a specified area of a bitmap. | Optical Character Recognition checks |
check toast message | Check the toast message on a mobile device against an expected string value. | Text-display checks |
check toolbar button exists | Check for the existence of a button on a toolbar. | Existence checks |
check toolbar button not exists | Check for the nonexistence of a button on a toolbar. | Existence checks |
check toolbar button state | Check the state of a button on a toolbar against an expected state. | Status checks |
check toolbar control value | Check the displayed text of a text box or a combo box control on a toolbar against an expected value. | Text-display checks |
check toolbar menu item exists | Check for the existence of an item on a drop-down menu hosted by a toolbar button (that is, a drop-down menu that appears when user clicks a button on a toolbar). | Existence checks |
check toolbar menu item not exists | Check for the nonexistence of an item on a drop-down menu hosted by a toolbar button (that is, a drop-down menu that appears when one clicks a button on a toolbar). | Existence checks |
check toolbar menu state | Check, against an expected value, the state of an item on a drop-down menu hosted by a toolbar button (that is, a drop-down menu that appears when user clicks a button on a toolbar). | Status checks |
check trackbar value | Check the value of a trackbar(slider) against an expected value. | Status checks |
check tree node exists | Check for the existence of a specified tree node. | Existence checks |
check tree node menu state | Check the state of a specified menu item on a context menu of a tree node against an expected value. | Status checks |
check tree node not exists | Check for the nonexistence of a specified tree node. | Existence checks |
check tree node status | Check the current status of a tree node. | Status checks |
check value | Check the contents of an argument against an expected value. | Get actions |
check window exists | Check for the existence of a specified window. | Existence checks |
check window not exists | Check for the nonexistence of a specified window. | Existence checks |
check window property | Check the value of a specified TA property of a window against an expected value. | Property checks |
check xml query result | Check an XPath query result against an expected string. | Get actions |
manual check | Display a modal dialog box asking user to perform a manual check. | |
report check | Register a Passed or Failed check result in the test results, accompanied by user-defined text. | Get actions |
The following topics provide more information about TestArchitect check actions.
Existence checks
How to work with checks that verify the existence of windows, controls, or items in an AUT.
Text-display checks
Working with checks that verify expected text in a control.
Status checks
How to implement test scripts that verify the status of a control.
Property checks
How to make property checks of specified windows or controls.
Image checks
How to create test procedures that compare images.
System checks
How to create test procedures that verify your test machine’s system data, including operating system, clipboard, files, and folders.
Optical Character Recognition checks
How to create a test procedure that verifies text on a control using Optical Character Recognition.
Get actions
Use the get built-in action together with the check built-in action to retrieve and check a value against an expected value.