click_by_alt

click_by_alt($alt,$exactly=true,$frame=-1,$wait_browser=true); - this function is used to emulate a mouse click on a page element, finding it by the specified alt or part of it.

the input Function accepts parameters:

$alt – alt by which we find the element we need on the page (string). To find out the alt 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 alt when searching for an element (boolean), by default 1 - the element's alt must completely match the passed parameter ($alt). if this parameter is set as 0, the first element whose alt contains the specified string will be found ($alt). Starting from version 7.0.25, you can fart the value 2, then alt will be interpreted as a regular expression for the Java Script String.search function.

$wait_browser – check and wait for the end of navigation (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:

  image->".basename(__FILE__)." ";

//1
echo "1.Let's go to the polygon:";
echo $browser->navigate("http://humanemulator.net/poligon/image.html")."
";

//2
echo "2.Click on the element with alt equal to screenshot:";
echo $image->click_by_alt("screenshot", true)."
";

//3
echo "3.Click on the src element containing shot 1:";
echo $image->click_by_alt("shot 1", false)."
";

//4
echo "4.Click on the nonexistent page element:";
if(!$image->click_by_alt("ptych", true))
   echo "no such element 
";

//five
echo "5.Click on the src element containing the screenshot in frame zero:";
echo $image->click_by_alt("screenshot", false, 0)."
";

//6
echo "6.Click on the nonexistent element in the zero frame:";
if(!$image->click_by_alt("ptyc", true, 0))
echo "no such element 
";

//7
echo "7.Click on an element in a non-existent frame:";
if(!$image->click_by_alt("screenshot", false, 4))
echo "no such frame";

//end
echo "
 
";

//Quit
$app->quit();
?>

Python example:

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7019"
from xweb_human_emulator import *

# Start
echo("
  common.click_by_alt  ")

# 1
echo("1.Let's go to the polygon:")
echo(browser.navigate("http://www.humanemulator.net/poligon/image.html"), "
")

# 2
echo("2.Click on the element with alt equal to screenshot:")
echo(image.click_by_alt("screenshot", true), "
")

# 3
echo("3.Click on the src element containing shot 1:")
echo(image.click_by_alt("shot 1", false), "
")

# 4
echo("4.Click on a nonexistent page element:")
if not image.click_by_alt("ptych", true):
   echo("no such item 
")

# five
echo("5.Click on the src element containing the screenshot in frame zero:")
echo(image.click_by_alt("screenshot", false, 0), "
")

# 6
echo("6.Click on a nonexistent element in frame zero:")
if not image.click_by_alt("ptyc", true, 0):
echo("no such item 
")

# 7
echo("7.Click on an element in a non-existent frame:")
if not image.click_by_alt("screenshot", false, 4):
echo("no such frame")

# end
echo("
 
")

# 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:7031";
InitXHE();

//Start
echo("
  click_by_alt  ");

//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("www.humanemulator.net/poligon/image.html") + "
");

//step 2
echo("2.Click on the element with alt equal to screenshot:");
echo(image.click_by_alt("screenshot", true) + "
");

//step 3
echo("3.Click on the src element containing shot 1:");
echo(image.click_by_alt("shot 1", false) + "
");

//step 4
echo("4.Click on a nonexistent page element:");
if(!image.click_by_alt("ptych", true))
echo("no such element 
");

//step 5
echo("5.Click on the element with src containing screenshot in frame zero:");
echo(image.click_by_alt("screenshot", false, "0") + "
");

//6 step
echo("6.Click on the nonexistent element in the zero frame:");
if(!image.click_by_alt("ptyc", true, "0"))
echo("no such element 
");

//step 7
echo("7.Click on an element in a non-existent frame:");
if(!image.click_by_alt("screenshot", false, "4"))
echo("no such frame");

//end
echo("
 
");

app.quit();
}
}

Java Script example:

console.log("-");
/*//IE + Chrom

//connect the object to control the emulator, if not already connected
xhe_host = "127.0.0.1:7012";

echo = require("../../../Templates JS/xweb_human_emulator.js");

//Start
echo("
  image.click_by_alt  ");

//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("http://www.humanemulator.net/poligon/image.html") + "
");

//step 2
echo("2.Click on the element with alt equal to screenshot:");
echo(image.click_by_alt("screenshot", true) + "
");

//step 3
echo("3.Click on the src element containing shot 1:");
echo(image.click_by_alt("shot 1", false) + "
");

//step 4
echo("4.Click on a nonexistent page element:");
if(!image.click_by_alt("ptych", true))
   echo("no such element 
");

//step 5
echo("5.Click on the element with src containing screenshot in frame zero:");
echo(image.click_by_alt("screenshot", false, 0) + "
");

//step 6
echo("6.Click on the nonexistent element in the zero frame:");
if(!image.click_by_alt("ptyc", true, 0))
echo("no such element 
");

//step 7
echo("7.Click on an element in a non-existent frame:");
if(!image.click_by_alt("screenshot", false, 4))
echo("no such frame");

//end
echo("
 
");

//Quit
app.quit(); */