Automation Guide Action-based testing language Built-in actions User Interface actions Toolbar, Menu, Scrollbar

 check menu item exists

check menu item exists

Description

Check for the existence of an item on a menu. Result is Passed ifthe specified menu item is found; otherwise Failed.

Arguments

• window

  TA name of the window.

• menu

  (Optional/Mandatory based on platform – see the Notes section below) TA name of the menu control.

• item

  Menu item or menu item path (see Notes).

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Notes

• menu argument:
  • The menuargument does not apply in the case of an AUT with a user interface based on the Windows API; in such cases, the argument should be omitted.
  • For other platforms, the menu control of interest should be captured as an interface element and passed to this action through themenu argument.
• item argument:
  • Menu items are identified by their caption properties.
  • If a menu path of more than one item must be specified, use arrow symbols ( -> ) as delimiters between menu items. For example, Vehicles->Cars->Four-door sedans.
• Since submenu items are not available on Android mobile devices, checking for the existence of a subitem is not supported on Android.
• This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only, item wait, object wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: menu.

Example - Case 1: Item on main menu of a Windows application

Action Lines

Result

Example - Case 2: Item on menu of a Java application

Action Lines

Result

Related information

does menu item exist