Sidebar



en:objects:common:get_dom:get_by_properties

get_by_properties

get_by_properties($properties,$frame=-1); - this function is used to get the DOM interface of a page element, finding it by one or more of its properties (attributes,coordinates, text sizes)

Available from version 4.10.10

The function accepts parameters as input:

  • $properties – string with the property search condition (string).

    Each condition in a string consists of 3 substrings separated by ; "property;value_property;condition" :

    • property - can be named attribute either x,y,width,height - dimensions and correlates , or inner_text.inner_html,outer_text,outer_html - texts
    • value_property - value of the property for comparison via the
    • condition - comparison condition :

      • 0 - contains the value
      • 1 - the value matches
      • 2 - the Value does not match
      • 3 - the Value is greater than the specified
      • 4 - Less than the specified value
    For example:

    • "id;list;1" - the first element with the attribute id=list.
    • "inner_text;DOM;1;x;200;3;y;500;3" - the first element with the text DOM and x>200 y>500:
    • "inner_text;DOM;0;x;200;4;y;500;4" - the first element with text that contains DOM and x<200 y<500:
  • $frame – the number of the frame in which we are looking for the element (string). Frame numbers start from zero. By default, -1 - the element is not in the frame. You can find out the number of the frame that contains the item you need from the task inspector, the context menu, and the item list panel.
    With version 4.6.41 of postpone: you can pass nested frames, the principle is the same, a string is numbered frames separated by : for example, if you transfer "1:0:5" - will the selected frame number 1 in it under the frame with the number 0 and the subframe number 5
    Since version 7.0.38, you can pass "url=>XXX", then search for the frame that contains the specified src, or pass "name=>XXX" - then the frame will be searched by the specified part of the name.

    After testing, the function returns the result of its work to the script :
  • DOM element interface – an object that allows you to quickly perform any operations with the found element, the return value type XHEInterface

    PHP example:

    <?php $xhe_host = "127.0.0.1:7013";
     
    //connect the object to control the emulator, if not already connected !!!
    if(!isset($path))
      $path = "../../../Templates/xweb_human_emulator.php";
    require($path);
     
    //Start
    echo "<hr> <font color = blue> anchor->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("http://humanemulator.net/poligon/anchor.html")."<br>";
     
    //2
    echo "2.Get the x and y of the link with alt = list and click on it:";
    $obj = $anchor->get_by_properties("alt; list; 1");
    echo $obj->get_x()."".$obj->get_y()."";
    echo $obj->click()."<br>";
     
    //3
    echo "3.Move mouse over element with DOM text and x> 200 y> 500:";
    $obj = $anchor->get_by_properties("inner_text; DOM; 1; x; 200; 3; y; 500; 3");
    echo $obj->mouse_move()." n";
     
    //4
    echo "4.Move mouse over element with text containing DOM and y <200 x <500:";
    $obj = $anchor->get_by_properties("inner_text; DOM; 0; x; 200; 4; y; 500; 4");
    echo $obj->mouse_move();
     
    //end
    echo "<hr> <br>";
     
    //Quit
    $app->quit();
    ?>

    Python example:

    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
     
    xhe_host = "127.0.0.1:7010"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.get_by_properties </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html"), "<br>")
     
    # 2
    echo("2.Get the x and y of the link with alt = list and click on it:")
    obj = anchor.get_by_properties("alt; list; 1")
    echo(obj.get_x(), "")
    echo(obj.get_y(), "")
    echo(obj.click(), "<br>")
     
    # 3
    echo("3.Move mouse over element with DOM text and x> 200 y> 500:")
    obj = anchor.get_by_properties("inner_text; DOM; 1; x; 200; 3; y; 500; 3")
    echo(obj.mouse_move(), "
    ")
     
    # 4
    echo("4.Move mouse over element with text containing DOM and y <200 x <500:")
    obj = anchor.get_by_properties("inner_text; DOM; 0; x; 200; 4; y; 500; 4")
    echo(obj.mouse_move())
     
    # end
    echo("<hr> <br>")
     
    # Quit
    app.quit()

    C# example:

    #region using
     
    using System;
    using System.Diagnostics;
    using System.Collections.Generic;
    using System.Linq;
    using System.IO;
    using System.Text;
    using System.Threading;
     
    using XHE;
    using XHE.XHE_DOM;
    using XHE.XHE_System;
    using XHE.XHE_Window;
    using XHE.XHE_Web;
     
    #endregion
     
     class Program: XHEScript
     {
    static void Main(string [] args)
    {
    //init XHE
    server = "127.0.0.1:7024";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> get_by_attribute </font> <hr>");
     
    //1
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html") + "<br>");
    sleep(1);
     
    //2
    echo("2.Get the x and y of the link with alt = list and click on it:");
    XHEInterface obj = anchor.get_by_properties("alt; list; 1");
    echo(obj.get_x() + "" + obj.get_y() + "");
    echo(obj.click() + "<br>");
     
    //3
    echo("3.Move mouse over element with DOM text and x> 200 y> 500:");
    obj = anchor.get_by_properties("inner_text; DOM; 1; x; 200; 3; y; 500; 3");
    echo(obj.mouse_move() + " n");
     
    //4
    echo("4.Move mouse over element with text containing DOM and y <200 x <500:");
    obj = anchor.get_by_properties("inner_text; DOM; 0; x; 200; 4; y; 500; 4");
    echo(obj.mouse_move());
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

     
  • en/objects/common/get_dom/get_by_properties.txt · Last modified: 2026/08/05 22:34 (external edit)