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 controla 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 if the 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.