Wait for Element


Pauses the execution of macro until the specified element is (or not) existed, visible, enabled, disabled etc. The common usage of the action is waiting for the webpage content. Because the webpage developers use AJAX or other skills to update the webpage realtime in some cases.

Parameters

  • Page name Specifies which page will be read. The webpage should be opened or connected before executing this action.

  • Wait action Specifies what to wait for. You can choose to wait for the element is visible, invisible, existed, not existed, disabled, or enabled.

  • Locate element by its path in page Specifies the element path in the page. For example: HTML.HEAD.TITLE

  • Locate element by its attributes

    • Element type must be Specifies the type of the element.

    • ID must be Specifies the element ID.

    • Name must be Specifies the element name.

    • Display text must be Specifies the display text for the element.

    • URL must be The option is for the hyperlink element.

    • Index of elements that match criteria Specifies the position of matched elements collection when more than one element meet the criteria.

    • Searching in main frame Specifies whether to search for the element in the main frame in the webpage.

    • Frame name must be Specifies the frame name if searching for the element in a specified frame.

    • Index of frames that match criteria If more than one frame has the same name, specifies the index of the frames collection.

    • Form name must be Specifies the form name if searching for the element in a specified form.

    • Index of forms that match criteria If more than one form has the same name, specifies the index of the forms collection.

    • Element attributes Specifies an attributes filter for the searching, using the standard HTML syntax, for example: id="abc" name="login"

    • Match case Specifies whether the search is case-sensitive.

    • Match whole word Specifies whether to search only for whole words that match the search content.

    • Only visible element Specifies whether to ignore the hidden elements.

  • Attribute of element must meet follow criteria Specifies a condition that must be satisfied to stop waiting.

Notes:

For time-out options, please refer to "Time out".

If the attribute name you want to check is not in the list of Attribute of element must meet follow criteria, you could type one in the field Attribute.