User Tools

Site Tools


Sidebar



en:objects:common:get_all_dom:get_all_by_properties

get_all_by_properties

get_all_by_properties($properties,$frame=-1); - this function is used to get a list of DOM interfaces of page elements, finding them by the specified properties. (Available from version 4.10.12)

  • $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 :
  • list of DOM interfaces of elements – an object that allows you to quickly perform any operations with all found elements (in fact, an array of interfaces to DOM elements that allows you to perform all operations together, which can be performed separately), the return value type XHEInterfaces

    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 numbers from links with alt = list:";
    $objs = $anchor->get_all_by_properties("alt; list; 1");
    print_r($objs->get_number());
    //click
    $objs->click();
     
    echo "3.Get numbers from elements with text containing DOM and y <200 x <500:";
    $objs = $anchor->get_all_by_properties("inner_text; DOM; 0; x; 200; 4; y; 500; 4");
    print_r($objs->get_number());
     
    //end
    echo "<hr> <br>";
     
    //Quit
    $app->quit();
    ?>

    Python example:

     

    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:7023";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> get_all_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 numbers from links with alt = list:");
    XHEInterfaces objs = anchor.get_all_by_properties("alt; list; 1");
    echo(objs.get_number());
    //click
    objs.click();
     
    echo("3.Get the numbers of elements with text containing DOM and y <200 x <500:");
    objs = anchor.get_all_by_properties("inner_text; DOM; 0; x; 200; 4; y; 500; 4");
    echo(objs.get_number());
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

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