User Tools

Site Tools


Sidebar

en:objects:image:is_complete:is_complete_by_name

is_complete_by_name

is_complete_by_name($name,$frame=-1); - this function is used to check whether the specified image is loaded on the current page by finding it by the specified name.

the input Function accepts parameters:

  • $name – the name by which we find the element we need on the page (string). To find out the name of an element, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $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 – a picture downloaded
  • false – the picture is not yet loaded or to find the item failed (e.g. no items that meet the specified criteria or not this frame)

    PHP example:

    <?php $xhe_host = "127.0.0.1:7014";
     
    //connect the object to control the emulator, if not already connected
    if(!isset($path))
      $path = "../../../Templates/xweb_human_emulator.php";
    require($path);
     
    //enable images
    $browser->enable_images(true);
    $browser->set_wait_params(0,0);
     
    //Start
    echo "<hr> <font color = blue> image->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    $browser->clear_cache();
    echo $browser->navigate("http://humanemulator.net/poligon/image.html", false)."<br>";
     
    //2
    echo "2.Let's display the loading status of an element named screen1:";
    for($i = 0; $i <20; $i ++)
    {
    usleep(200000);
    echo ".".$image->is_complete_by_name("screen1").".";
    }
     
    //3
    echo "<br> 3.Get the status of a nonexistent element:";
    if(!$image->is_complete_by_name("ptych"))
      echo "no such element <br>";
     
    //4
    echo "4.Let's go to the polygon:";
    $browser->clear_cache();
    echo $browser->navigate("http://humanemulator.net/poligon/image.html", false)."<br>";
     
    //five
    echo "5.Let's display the loading status of an element named screen1 in a zero frame:";
    for($i = 0; $i <20; $i ++)
    {
    usleep(200000);
    echo ".".$image->is_complete_by_name("screen1", 0).".";
    }
     
    //6
    echo "<br> 6.Get the status of a nonexistent element in the zero frame:";
    if(!$image->is_complete_by_name("ptych", 0))
      echo "no such element <br>";
     
    //7
    echo "7.Get the status of an element in a non-existent frame:";
    if(!$image->is_complete_by_name("screen1", 100500))
      echo "no such frame <br>";
     
    //end
    echo "<hr> <br>";
     
    $browser->set_wait_params(-1, -1);
     
    //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> image.xxxxxxxxx </font> <hr>")
     
    # let's resolve pictures
    browser.enable_images(true)
    browser.set_wait_params(0,0)
     
    # 1
    echo("1.Let's go to the polygon:")
    browser.clear_cache()
    echo(browser.navigate("http://www.humanemulator.net/poligon/image.html", false), "<br>")
     
    # 2
    echo("2.Give the loading status of an element named screen1:")
    for i in range(0,19):
    time.sleep(0.2)
    echo("." + str(image.is_complete_by_name("screen1")) + ".")
     
    # 3
    echo("<br> 3.Get the status of a nonexistent element:")
    if not image.is_complete_by_name("ptych"):
      echo("no such item <br>")
     
    # 4
    echo("4.Move to polygon:")
    browser.clear_cache()
    echo(browser.navigate("http://www.humanemulator.net/poligon/image.html", false), "<br>")
     
    # five
    echo("5.Give the loading status of an element named screen1 in a zero frame:")
    for i in range(0,19):
    time.sleep(0.2)
    echo("." + str(image.is_complete_by_name("screen1", 0)) + ".")
     
    # 6
    echo("<br> 6.Get the status of a nonexistent element in a zero frame:")
    if not image.is_complete_by_name("ptych", 0):
      echo("no such item <br>")
     
    # 7
    echo("7.Get the status of an element in a nonexistent frame:")
    if not image.is_complete_by_name("screen1", 100500):
      echo("no such frame <br>")
     
    # end
    echo("<hr> <br>")
     
    browser.set_wait_params(-1, -1)
     
    # 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> image.is_complete_by_name </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    browser.clear_cache();
    echo(browser.navigate("www.humanemulator.net/poligon/image.html", false) + "<br>");
     
    //step 2
    echo("2.Let's display the loading status of the element named screen1:");
    for(int i = 0; i <20; i ++)
    {
    Thread.Sleep(200);
    echo("." + image.is_complete_by_name("screen1") + ".");
    }
     
    //step 3
    echo("<br> 3.Get the status of a nonexistent element:");
    if(!image.is_complete_by_name("ptych"))
    echo("no such element <br>");
     
    //step 4
    echo("4.Let's go to the polygon:");
    echo(browser.clear_cache() + "");
    echo(browser.navigate("www.humanemulator.net/poligon/image.html", false) + "<br>");
     
    //step 5
    echo("5.Let's display the loading status of the element named screen1 in the zero frame:");
    for(int i = 0; i <20; i ++)
    {
    Thread.Sleep(200);
    echo("." + image.is_complete_by_name("screen1", "0") + ".");
    }
     
    //6 step
    echo("<br> 6.Get the status of a nonexistent element in the zero frame:");
    if(!image.is_complete_by_name("ptych", "0"))
    echo("no such element <br>");
     
    //step 7
    echo("7.Get the status of an element in a non-existent frame:");
    if(!image.is_complete_by_name("screen1", "100500"))
    echo("no such frame <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:7014";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //enable images
    browser.enable_images(true);
    browser.set_wait_params(0,0);
     
    //Start
    echo("<hr> <font color = blue> image.is_complete_by_name </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    browser.clear_cache();
    echo(browser.navigate("http://www.humanemulator.net/poligon/image.html", false) + "<br>");
     
    //step 2
    echo("2.Let's display the loading status of the element named screen1:");
    for(i = 0; i <20; i ++)
    {
    browser.sleep(1);
    echo("." + image.is_complete_by_name("screen1") + ".");
    }
     
    //step 3
    echo("<br> 3.Get the status of a nonexistent element:");
    if(!image.is_complete_by_name("ptych"))
      echo("no such element <br>");
     
    //step 4
    echo("4.Let's go to the polygon:");
    browser.clear_cache();
    echo(browser.navigate("http://www.humanemulator.net/poligon/image.html", false) + "<br>");
     
    //step 5
    echo("5.Let's display the loading status of the element named screen1 in the zero frame:");
    for(i = 0; i <20; i ++)
    {
    browser.sleep(1);
    echo("." + image.is_complete_by_name("screen1", 0) + ".");
    }
     
    //step 6
    echo("<br> 6.Get the status of a nonexistent element in the zero frame:");
    if(!image.is_complete_by_name("ptych", 0))
      echo("no such element <br>");
     
    //step 7
    echo("7.Get the status of an element in a non-existent frame:");
    if(!image.is_complete_by_name("screen1", 100500))
      echo("no such frame <br>");
     
    //end
    echo("<hr> <br>");
     
    browser.set_wait_params(-1, -1);
     
    //Quit
    app.quit();
  • en/objects/image/is_complete/is_complete_by_name.txt · Last modified: 2026/08/05 22:44 (external edit)