Skip to content
ActionsDotWork logo ActionsDotWork. Docs
Browser Actions icon Home › Browser Actions 2024.0.8 › Actions

Browser Actions › Actions › Select Menu Item (β)

Tries to find a specific UI menu element, and trigger it. If the element is a menu or submenu, that triggering will open the menu. If the element is a menu item, its related function will be called.

On success, the action will return a menu item reference which can be used as input in other menu actions of Browser Actions.

The action will raise an error if the requested menu item couldn't be found.

Parameters

Browser

The browser to work with.

Selecting "frontmost browser" will only work if the application currently in the foreground is a supported browser.

Type: Browser

Targeting options

You can look up a menu item or sub menu by either …

  • its "title", e.g. Contacts…
  • its "path", e.g. Edit > AutoFill > Contacts…
  • its "segmented path", e.g. Edit, AutoFill, Contacts…
  • its "reference", i.e. Menu Item returned by another Shortcuts action.

A menu path is a single string containing the path segments separated by ">".

Leading and trailing whitespace in segments is trimmed. The lookup deals gracefully with segments ending in either an ellipses or triple dots, if either variant exists in the menu structure, it'll be found.

Options:

  • title
  • path
  • segmented path
  • reference

The menu item label as it occurs in the actual menu. Depending on the selected filter criteria, a partial title might be enough.

Type: Text

Title filter criteria

Only available when searching by title.

Options:

  • is
  • contains
  • begins with
  • ends with
  • matches regular expression

Case-insensitive filtering

Enable if lowercase and uppercase shouldn't make a difference. Only available when searching by title or path.

Type: Boolean (YES/NO)

The menu item's hierarchical path, starting at the main menu, separated by ">" characters, e.g. View > Translation > Translate to German.

During the lookup, the path will be split up by ">", and any leading or trailing whitespace in the single segments will be trimmed.

Type: Text

The first segment of a menu item's path, e.g. View or Edit etc.

Type: Text

The next segment of the menu item's path.

Type: Text

The next segment of the menu item's path.

Type: Text

The next segment of the menu item's path.

Type: Text

The next segment of the menu item's path.

Type: Text

The result of another menu action of Browser Actions.

Type: Menu Item

Pause after selecting

This adds a short pause after selecting the menu item.

Options:

  • no pause
  • 0.2 secs
  • 0.5 secs
  • 1.0 secs
  • 1.5 secs
  • 2.0 secs
  • 3.0 secs
  • 4.0 secs

Return Value

Menu Item

Short Video Explainer

"Select Menu Item (β)" video explainer: