get_number_by_href

get_number_by_href($href,$exactly=true,$frame=-1); - this function is used to get the element number on the page (numbering starts from zero), finding it by the specified href or part of it. (Available from version 4.6.3)

the input Function accepts parameters:

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

$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 :

item number is the number of the found element (numbering of elements starts at zero), the return type of string

-1 to find this element failed (e.g. no items that meet the specified criteria or not this frame), the return type int

PHP example:

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

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

//2
echo "2.Get the element number by its href:";
echo $anchor->get_number_by_href("http://www.humanemulator.net/objects.php", true)."
";

//3
echo "3.Get the number of the element by its href:";
echo $anchor->get_number_by_href("carnote", false)."
";

//4
echo "4.Get the number of a nonexistent item:";
if($anchor->get_number_by_href("screenshot234", true) == - 1)
  echo "no such element 
";

//five
echo "5.Get the number of the element by its href in the zero frame:";
echo $anchor->get_number_by_href("http://humanemulator.net/objects.php", true, 0)."
";

//6
echo "6.Get the number of the element by its href part in the zero frame:";
echo $anchor->get_number_by_href("carnote", false, 0)."
";

//7
echo "7.Get the number of the non-existent element in the zero frame:";
if($anchor->get_number_by_href("screenshot234", true, 0) == - 1)
  echo "no such element 
";

//8
echo "8.Get the element number in a non-existent frame:";
if($anchor->get_number_by_href("carnote", false, 100500) == - 1)
  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:7010"
from xweb_human_emulator import *

# Start
echo("
  common.get_number_by_href  ")

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

# 2
echo("2.Get the element number by its href:")
echo(anchor.get_number_by_href("http://www.humanemulator.net/objects.php", true), "
")

# 3
echo("3.Get the number of the element by its href:")
echo(anchor.get_number_by_href("carnote", false), "
")

# 4
echo("4.Get the number of a nonexistent item:")
if anchor.get_number_by_href("screenshot234", true) == - 1:
  echo("no such item 
")

# five
echo("5.Get the element number by its href in frame zero:")
echo(anchor.get_number_by_href("http://www.humanemulator.net/objects.php", true, 0), "
")

# 6
echo("6.Get the element number by part of its href in frame zero:")
echo(anchor.get_number_by_href("carnote", false, 0), "
")

# 7
echo("7.Get the number of a nonexistent element in frame zero:")
if anchor.get_number_by_href("screenshot234", true, 0) == - 1:
  echo("no such item 
")

# 8
echo("8.Get item number in non-existent frame:")
if anchor.get_number_by_href("carnote", false, 100500) == - 1:
  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:7010";
InitXHE();

//Start
echo("
  get_number_by_href  ");

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

//step 2
echo("2.Get the element number by its href:");
echo(anchor.get_number_by_href("http://www.humanemulator.net/objects.php", true) + "
");

//step 3
echo("3.Get the number of the element from its href:");
echo(anchor.get_number_by_href("carnote", false) + "
");

//step 4
echo("4.Get the number of a nonexistent element:");
if(anchor.get_number_by_href("screenshot234", true) == - 1)
echo("no such element 
");

//end
echo("
 
");

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("
  image.get_number_by_href  ");

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

//step 2
echo("2.Get the element number by its href:");
echo(anchor.get_number_by_href("http://www.humanemulator.net/objects.php", true) + "
");

//step 3
echo("3.Get the number of the element from its href:");
echo(anchor.get_number_by_href("carnote", false) + "
");

//step 4
echo("4.Get the number of a nonexistent element:");
if(anchor.get_number_by_href("screenshot234", true) == - 1)
  echo("no such element 
");

//step 5
echo("5.Get element number by its href in zero frame:");
echo(anchor.get_number_by_href("http://www.humanemulator.net/objects.php", true, 0) + "
");

//step 6
echo("6.Get the element number by part of its href in the zero frame:");
echo(anchor.get_number_by_href("carnote", false, 0) + "
");

//step 7
echo("7.Get the number of the nonexistent element in the zero frame:");
if(anchor.get_number_by_href("screenshot234", true, 0) == - 1)
  echo("no such element 
");

//step 8
echo("8.Get item number in non-existent frame:");
if(anchor.get_number_by_href("carnote", false, 100500) == - 1)
  echo("no such frame 
");

//end
echo("
 
");

//Quit
app.quit();