User Tools

Site Tools


Sidebar



en:objects:common:is_exist:is_exist_by_href

is_exist_by_href

is_exist_by_href($href,$exactly=true,$frame=-1); - this function is used to check the presence of an element on the page, finding it by the specified href or part of it.

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 (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:7013";
     
    //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>";
     
    //2
    echo "2.Check if there is a link with this href:";
    echo $anchor->is_exist_by_href("http://www.humanemulator.net/1/", true)." n";
     
    //3
    echo "3.Check if there is a link containing the given href:";
    echo $anchor->is_exist_by_href("23", false)." n";
     
    //4
    echo "4.Checking a non-existent element:";
    if($anchor->is_exist_by_href("shindler's list", false) === false)
         echo "element not exist  n";
     
    //five
    echo "5.Check if there is a link with this href in the zero frame:";
    echo $anchor->is_exist_by_href("http://humanemulator.net/1/", true, 0)." n";
     
    //6
    echo "6.Check if there is a link containing the given href in a null frame:";
    echo $anchor->is_exist_by_href("23", false, 0)." n";
     
    //7
    echo "7.Check for non-existent element in frame zero:";
    if($anchor->is_exist_by_href("ptych", false, 0) === false)
         echo "element not exist";
     
    //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.xxxxxxxxx </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html"), "<br>")
     
    # 2
    echo("2.Check if there is a link with this href:")
    echo(anchor.is_exist_by_href("http://www.humanemulator.net/1/", true), "
    ")
     
    # 3
    echo("3.Check if there is a link containing the given href:")
    echo(anchor.is_exist_by_href("23", false), "
    ")
     
    # 4
    echo("4.Checking a non-existent element:")
    if not anchor.is_exist_by_href("shindler list", false):
         echo("element not exist
    ")
     
    # five
    echo("5.Check if there is a link with this href in the zero frame:")
    echo(anchor.is_exist_by_href("http://www.humanemulator.net/1/", true, 0), "
    ")
     
    # 6
    echo("6.Check if there is a link containing the given href in a zero frame:")
    echo(anchor.is_exist_by_href("23", false, 0), "
    ")
     
    # 7
    echo("7.Checking for nonexistent element in frame zero:")
    if not anchor.is_exist_by_href("ptych", false, 0):
         echo("element not exist")
     
    # 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> is_exist_by_href </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.Check if there is a link with this href:");
    if(anchor.is_exist_by_href("http://www.humanemulator.net/objects.php", true))
    echo("found with completely the same href <br>");
     
    //step 3
    echo("3.Check if there is a link in the href:");
    if(anchor.is_exist_by_href("objects.php", false))
    echo("found with part of such href <br>");
     
    //step 4
    echo("4.Check if there is no such element:");
    if(!anchor.is_exist_by_href("shindler list", false))
    echo("there is no link with this href");
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

    //IE + Chrom
     
    //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.is_exist_by_href </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.Check if there is a link with this href:");
    echo(anchor.is_exist_by_href("http://www.humanemulator.net/1/", true) + " n");
     
    //step 3
    echo("3.Check if there is a link containing the given href:");
    echo(anchor.is_exist_by_href("23", false) + " n");
     
    //step 4
    echo("4.Checking a non-existent element:");
    if(anchor.is_exist_by_href("shindler's list", false) === false)
         echo("element not exist  n");
     
    //step 5
    echo("5.Check if there is a link with this href in the zero frame:");
    echo(anchor.is_exist_by_href("http://www.humanemulator.net/1/", true, 0) + " n");
     
    //step 6
    echo("6.Check if there is a link containing the given href in a zero frame:");
    echo(anchor.is_exist_by_href("23", false, 0) + " n");
     
    //step 7
    echo("7.Checking for a non-existent element in the zero frame:");
    if(anchor.is_exist_by_href("ptych", false, 0) === false)
         echo("element not exist");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/common/is_exist/is_exist_by_href.txt · Last modified: 2026/08/05 22:34 (external edit)