User Tools

Site Tools


Sidebar



en:objects:common:click:click_by_name_by_form_name

click_by_name_by_form_name

click_by_name_by_form_name($name,$form_name,$frame=-1,$wait_browser=true); - this function is used to emulate a mouse click on a page element, finding it by the specified name - in a form with the specified name.

the input Function accepts parameters:

  • $name – the name by which we find the element we need in the specified form (string) . To find out the name of an element in a form, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $form_name – name of the form in which we are looking for the element (string). You can find out the name of the form that contains the item you need from the task inspector, the context menu, and the list of items panel.
  • $wait_browser – check and wait for navigation to finish (available from version 7.0.21)
  • $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 the function returns the result of their work in the script (the return value type is boolean):
  • true – executed successfully
  • false to find this element failed (e.g. no items that meet the specified criteria or not this frame)

    PHP example:

    <?php $xhe_host = "127.0.0.1:7016";
     
    //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> button->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("http://humanemulator.net/poligon/button.html")."<br>";
     
    //2
    echo "2.Click on the element named btn1f in the form named form1:";
    echo $button->click_by_name_by_form_name("btn1f", "form1")."<br>";
     
    //3
    echo "3.Click on a nonexistent element in the form:";
    if(!$button->click_by_name_by_form_name("Button", "form1"))
      echo "no such element <br>";
     
    //4
    echo "4.Click on an element in a nonexistent form:";
    if(!$button->click_by_name_by_form_name("btn1f", "ptych"))
      echo "no such form <br>";
     
    //five
    echo "5.Click on the element named btn1f in the form named form1 in the null frame:";
    echo $button->click_by_name_by_form_name("btn1f", "form1", 0)."<br>";
     
    //6
    echo "6.Click on the nonexistent form element in the zero frame:";
    if(!$button->click_by_name_by_form_name("Button", "form1", 0))
      echo "no such element <br>";
     
    //7
    echo "7.Click on an element in a nonexistent form in frame zero:";
    if(!$button->click_by_name_by_form_name("btn1f", "ptych", 0))
      echo "no such form <br>";
     
    //8
    echo "8.Click on an element in a non-existent frame:";
    if(!$button->click_by_name_by_form_name("btn1f", "form1", 5))
      echo "no such form <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:7010"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.click_by_name_by_form_name </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/button.html"), "<br>")
     
    # 2
    echo("2.Click on the element named btn1f in the form named form1:")
    echo(button.click_by_name_by_form_name("btn1f", "form1"), "<br>")
     
    # 3
    echo("3.Click on a nonexistent element in the form:")
    if not button.click_by_name_by_form_name("Button", "form1"):
      echo("no such item <br>")
     
    # 4
    echo("4.Click on an element in a nonexistent form:")
    if not button.click_by_name_by_form_name("btn1f", "ptych"):
      echo("no such form <br>")
     
    # five
    echo("5.Click on the element named btn1f in the form named form1 in the null frame:")
    echo(button.click_by_name_by_form_name("btn1f", "form1", 0), "<br>")
     
    # 6
    echo("6.Click on a nonexistent form element in frame zero:")
    if not button.click_by_name_by_form_name("Button", "form1", 0):
      echo("no such item <br>")
     
    # 7
    echo("7.Click on an element in a nonexistent form in frame zero:")
    if not button.click_by_name_by_form_name("btn1f", "ptych", 0):
      echo("no such form <br>")
     
    # 8
    echo("8.Click on an element in a non-existent frame:")
    if not button.click_by_name_by_form_name("btn1f", "form1", 5):
      echo("no such form <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:7010";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> click_by_name_by_form_name </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/button.html") + "<br>");
     
    //step 2
    echo("2.Click on the element named btn1f in the form named form1:");
    echo(button.click_by_name_by_form_name("btn1f", "form1") + "<br>");
     
    //step 3
    echo("3.Click on a non-existent element in the form:");
    if(!button.click_by_name_by_form_name("Button", "form1"))
    echo("no such element <br>");
     
    //step 4
    echo("4.Click on an element in a nonexistent form:");
    if(!button.click_by_name_by_form_name("btn1f", "ptych"))
    echo("no such form <br>");
     
    //step 5
    echo("5.Click on the element named btn1f in the form named form1 in the null frame:");
    echo(button.click_by_name_by_form_name("btn1f", "form1", "0") + "<br>");
     
    //6 step
    echo("6.Click on a nonexistent form element in frame zero:");
    if(!button.click_by_name_by_form_name("Button", "form1", "0"))
    echo("no such element <br>");
     
    //step 7
    echo("7.Click on an element in a nonexistent form in frame zero:");
    if(!button.click_by_name_by_form_name("btn1f", "ptych", "0"))
    echo("no such form <br>");
     
    //step 8
    echo("8.Click on an element in a non-existent frame:");
    if(!button.click_by_name_by_form_name("btn1f", "form1", "5"))
    echo("no such form <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> button.click_by_name_by_form_name </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/button.html") + "<br>");
     
    //step 2
    echo("2.Click on the element named btn1f in the form named form1:");
    echo(button.click_by_name_by_form_name("btn1f", "form1") + "<br>");
     
    //step 3
    echo("3.Click on a non-existent element in the form:");
    if(!button.click_by_name_by_form_name("Button", "form1"))
      echo("no such element <br>");
     
    //step 4
    echo("4.Click on an element in a nonexistent form:");
    if(!button.click_by_name_by_form_name("btn1f", "ptych"))
      echo("no such form <br>");
     
    //step 5
    echo("5.Click on the element named btn1f in the form named form1 in the null frame:");
    echo(button.click_by_name_by_form_name("btn1f", "form1", 0) + "<br>");
     
    //step 6
    echo("6.Click on a nonexistent form element in frame zero:");
    if(!button.click_by_name_by_form_name("Button", "form1", 0))
      echo("no such element <br>");
     
    //step 7
    echo("7.Click on an element in a nonexistent form in frame zero:");
    if(!button.click_by_name_by_form_name("btn1f", "ptych", 0))
      echo("no such form <br>");
     
    //step 8
    echo("8.Click on an element in a non-existent frame:");
    if(!button.click_by_name_by_form_name("btn1f", "form1", 5))
      echo("no such form <br>");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/common/click/click_by_name_by_form_name.txt · Last modified: 2026/08/05 22:33 (external edit)