en:objects:common:wait:wait_element_exist_by_attribute_by_form

wait_element_exist_by_attribute_by_form_name

wait_element_exist_by_attribute_by_form_name($attr_name,$attr_value,$exactly,$form_name,$frame=-1); - this function is used to wait for the page element to appear, checking it by the value of the specified attribute in the form with the specified name.

Available from version 7.0.45

the input Function accepts parameters:

$attr_name – name of the attribute to search for (string). To find out the attribute names of an element, you can use either the element inspector, the context menu, or view it in the list of elements.

$attr_value – the attribute value that we will use to search for an element in the specified form (string). To find out the value of a given attribute for an element, you can use either the element inspector, the context menu, or view it in the list of elements.

$exactly - exact match of the value of the specified attribute when searching for an element (boolean), if true - the value of the specified element attribute must completely match the passed parameter ($attr_value). if this parameter is set as false, the first element of the specified type in the form is found, where the value of the specified attribute contains the specified string ($attr_value). Starting from version 7.0.25, you can fart the value 2. then attr_value will be interpreted as a regular expression for the Java Script function String. search.

$form_name – the 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.

$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> 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.Waiting for an element named btn1f in a form named form1:";
echo $button->wait_element_exist_by_attribute_by_form_name("name", "btn1f", true, "form1")."<br>";
 
//3
echo "3.Click on the element named btn1f in the form named form1:";
echo $button->click_by_attribute_by_form_name("name", "btn1f", true, "form1")."<br>";
 
//4
echo "4.Expecting an element named btn1f in a form named form1 in a null frame:";
echo $button->wait_element_exist_by_attribute_by_form_name("name", "btn1f", true, "form1", 0)."<br>";
 
//five
echo "5.Click on the element named btn1f in the form named form1 in the null frame:";
echo $button->click_by_attribute_by_form_name("name", "btn1f", true, "form1", 0)."<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_attribute_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.Wait for an element named btn1f in a form named form1:")
button.wait_element_exist_by_attribute_by_form_name("name", "btn1f", true, "form1")
 
# 3
echo("3.Click on an element named btn1f in a form named form1:")
echo(button.click_by_attribute_by_form_name("name", "btn1f", true, "form1"), "<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_attribute_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.Expecting an element named btn1f in a form named form1:");
button.wait_element_exist_by_attribute_by_form_name("name", "btn1f", 1, "form1", "- 1");
 
                       //step 3
echo("3.Click on the element named btn1f in the form named form1:");
echo(button.click_by_attribute_by_form_name("name", "btn1f", 1, "form1") + "<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.wait_element_exist_by_attribute_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.Let's wait for an element named btn1f in a form named form1:");
button.click_by_attribute_by_form_name("name", "btn1f", true, "form1");
 
//step 2
echo("2.Click on the element named btn1f in the form named form1:");
echo(button.wait_element_exist_by_attribute_by_form_name("name", "btn1f", true, "form1") + "<br>");
 
//end
echo("<hr> <br>");
 
//Quit
app.quit();