wait_element_exist_by_outer_text

wait_element_exist_by_outer_text($outer_text,$exactly=true,$frame=-1); - this function is used to wait for a page element to appear, checking it against the specified external text or part of it.

Available from version 7.0.45

the input Function accepts parameters:

  • $outer_text – internal text that we use to find the element we need on the page (string). To find out the internal text of an element, you can use either the element inspector or the context menu, or view it in the list of elements.
  • $exactly – exact match of the external text when searching for an element (boolean), by default true - the external text of the element must completely match the passed parameter ($outer_text). if this parameter is set as false, the first element with the specified string in the external text will be found ($outer_text).
  • $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 list of items 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.

    The element timeout is set using the variable $iSecondsWaitElementExistBeforeAction=15; //how many seconds to wait for the element to appear defined in the template file xweb_human_emulator for each language.



    PHP example:

    <?php $xhe_host = "127.0.0.1:7011";
     
    //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>";
     
    echo "2.Check and wait for the link with the text \ u0022Automotive site \ u0022 <br>";
    $anchor->wait_element_exist_by_outer_text("Automotive site", true);
    //3
    echo "3.Get x and y from link c \ u0022Automotive site \ u0022 and click on it:";
    $obj = $anchor->get_by_outer_text("Automotive Site");
    echo $obj->get_x()."".$obj->get_y()."";
    echo $obj->click()."<br>";
     
    //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:7011"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.wait_element_exist_by_outer_text </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html"), "<br>")
     
    # 3
    echo("3.Wait for the link c \ u0022Automotive site \ u0022 and click on it:")
    anchor.wait_element_exist_by_outer_text("Automotive site", true)
     
    # 2
    echo("2.Get x and y from link c \ u0022Automotive site \ u0022 and click on it:")
    obj = anchor.get_by_outer_text("Automotive Site")
    echo(obj.get_x(), "")
    echo(obj.get_y(), "")
    echo(obj.click(), "<br>")
     
    # 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:7011";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> wait_element_exist_by_outer_text </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/anchor.html") + "<br>");
     
                           //step 2
    echo("2.Let's wait for the link with external text \ u0022Automotive site \ u0022 and click on it:");
                anchor.wait_element_exist_by_outer_text("Automotive site", 1, "- 1");
     
    //step 3
    echo("3.Get the x and y of the link with the outer text \ u0022Automotive site \ u0022 and click on it:");
    XHEInterface obj = anchor.get_by_outer_text("Automotive Site");
    echo(obj.get_x() + "" + obj.get_y() + "");
    echo(obj.click() + "<br>");
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

    //connect the object to control the emulator, if not already connected
    xhe_host = "127.0.0.1:7010";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //Start
    echo("<hr> <font color = blue> anchor.wait_element_exist_by_outer_text </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html") + "<br>");
     
    //step 2
    echo("2.Wait for link c \ u0022Automotive site \ u0022:");
    anchor.wait_element_exist_by_outer_text("Automotive Site");
     
    //step 3
    echo("3.Get x and y from link c \ u0022Automotive site \ u0022 and click on it:");
    obj = anchor.get_by_inner_text("Automotive Site");
    echo(obj.get_x() + "" + obj.get_y() + "");
    echo(obj.click() + "<br>");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();