Find Element on a Webpage


Searches the webpage for the element that matches the specified criteria. You can also use this action to gather the display text of the element.

Parameters

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

  • 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.

  • Populate variable with result Specifies the name of the variable to which stores the result (the number 1 or 0).

  • Set keyboard focus to element Specifies whether to set the cursor focus to the element.

  • Read what Specifies the content to be read, it can be one of the following:

    • Don't read content
    • Read inner text
    • Read inner HTML
    • Read attribute value
    • Read content user typed
    • Retrieve element's path in webpage

Notes:

If an element matches the criteria, the value of the global variable "error" will be a string "OK", otherwise, it will be set to the string "WAR".