<list-expect>

The <list-expect> element verifies the contents of a list control on a list screen. It can also verify a detail screen field with an edit type of List View. This element can verify the contents of the list, including the number of rows display, the number of selected rows, the values displayed in each column for each row, the presence of a value in a column in any row, the contents of the list’s header label and detail pane, and the contents of the column header on each column within the list. When used on a detail screen containing multiple lists, the specific list to verify can be found using the field’s name or label. If the list does not meet the expected criteria a script error is thrown. The expected values and state of the list and its items can be specified using the elements attributes as well as the elements it can contain.

Structure

Contains:
  • Text - The value to use to locate the desired row to verify within the list. Text content and element content are mutually exclusive for the <list-expect> element.
  • <row>
  • <column>
  • <header>
  • <columnheader>
  • <detail>
Contained By:
  • <script>
Attributes
Name Description Data Type Default Value Required
column This attribute specifies the column to be verified by the <list-expect> element. This may be either the column’s header label or a numeric value indicating the columns position from left to right, with the left-most column at position 1. string None No
count This attribute specifies the total number of rows the list should contain. This may any numeric integer no less than zero. non-negative integer None No
selected-count This attribute specifies the total number of rows currently selected in the list. This may any numeric integer no less than zero. non-negative integer None No
common list attributes This element includes the following common list attributes:
  • name
  • id
  • label
  • row
  • column
N/A N/A N/A
common script attributes A set of related attributes common to most elements within the Agentry Test Script. N/A N/A N/A