Show TOC

<tab-expect>Locate this document in the navigation structure

The <tab-expect> element can be used to verify the label of a tab. The contents of the element specify the label expected to be displayed for the tab. The tab may be specified based on the screen definition’s name, the screen’s position index, a position relative to the currently selected tab’s position, or by specifying the first or last tab from left to right. If the tab’s label does not match the text contents of the <tab-expect> element a script error is thrown. If the tab, name, and label attributes are all omitted from this element, the currently selected tab’s label is verified.

Structure
Contains:
  • Text - The expected label for the tab.
Contained By:
  • <script>
Table 1: Attributes
Name Description Data Type Default Value Required
tab This attribute can be set to specify the tab to select based on its position relative to the currently selected tab, the first or last tab, or by specifying a positive integer matching the screen’s position index within the screen set. Valid values for this attribute include:
  • first - The first (or left-most) tab displayed.
  • last - The last (or right-most) tab displayed.
  • next - The next tab to the right of the currently selected tab.
  • previous - The previous tab to the right of the currently selected tab.
  • A positive integer matching the screen definitions position within the screen set.
String None No
name This attribute can be set to the screen definitions name to specify the tab whose label is to be verified. String None No
label This attribute can be set to specify the label for the tab whose label is to be verified. While supported for the <tab-expect> element, it makes little sense to use this attribute. String None No
common script attributes This element includes the following common script attributes:
  • timeout
  • sleep
N/A N/A N/A