<tree-expect>

The <tree-expect> is used to verify the expected state and values of a tree control node. This element will contain one or more <node> elements. The <tree-expect> node specifies the node to be verified. Information the tree-expect node will verify includes the existence of the specified node and the total count of child nodes it contains. The <node> elements contained in a <tree-expect> then specify the expected child nodes of that node. The <tree-expect> node specifies the type of verification to perform for the specified node in the tree control. This options are to verify the child nodes match those <node> elements within <tree-expect> exactly, or to verify the child nodes include those <node> elements within the <tree-expect>. In the case of the latter verification, other child nodes may exist in the tree control. The first verification is referred to as an “exact” verification type. The latter is a “sub-set” verification. If the selected tree control node does not match the parameters of the <tree-expect> element, a script error is thrown.

Structure

Contains:
  • Text - The expected contents of the specified node in the tree control.
  • <node>
Contained By:
  • <script>
Attributes
Name Description Data Type Default Value Required
count This attribute can specify the expected number of child nodes for the specified node being verified. If this attribute is not provided, the count of child nodes is not performed or checked. non-negative integer N/A No
type This attribute specifies the type of verification to perform. Valid values for this attribute are:
  • exact - All child nodes for the tree control node must exactly match all <node> elements contained in the <tree-expect> element.
  • sub-set - For each <node> element contained in the <tree-expect> element there must be a matching child node in the tree control Additional child nodes may also exist.
string sub-set No
common tree control attributes This element includes the following common tree control attribute:
  • label
  • node
  • sibling
  • child
N/A N/A N/A
common script attributes This element includes the following common script attributes:
  • timeout
  • sleep
N/A N/A N/A