Sidebar



en:objects:frame:body:get_body_by_number

get_body_by_number

get_body_by_number($number,$as_html,$frame=-1); - this function is used to get the body of the specified frame, finding it by the specified number.

the input Function accepts parameters:

  • $number – the number by which we find the element we need on the page (int) . Element numbers start with 0 and different types of elements have their own numbering.To find out the item number, you can use either the item inspector or the context menu, or view it in the list of items.
  • $as_html – result format - as html (boolean). If false is set, It returns just text (without HTML tags).
  • $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 testing, the function returns the result of its work to the script :
  • frame body – the frame body in HTML5 (with all tags) or text format (without tags, only visible text)
  • false – it was not possible to find such a frame (for example, there are no frames that meet the specified criteria or there is no such frame), the return value type is boolean

    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);
     
    //Start
    echo "<hr> <font color = blue> frame->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("http://humanemulator.net/poligon/anchor.html")."<br> <br>";
     
    //2
    echo "2.Get body of frame 0 as html:";
    echo $frame->get_body_by_number(0, true)."<br> <br>";
     
    //3
    echo "3.Get the body of frame 0 as text:";
    echo $frame->get_body_by_number(0, false)."<br> <br>";
     
    //4
    echo "4.Get the body of a non-existent frame:";
    if(!$frame->get_body_by_number(100500, false))
    echo "no such element <br> <br>";
     
    //five
    echo "5.Get the body of frame 0 as text in frame zero:";
    echo $frame->get_body_by_number(0, true, 0)."<br> <br>";
     
    //6
    echo "6.Get the body of a nonexistent frame in frame zero:";
    if(!$frame->get_body_by_number(100500, false, 0))
    echo "no such element <br> <br>";
     
    //7
    echo "7.Get the body of a frame in a non-existent frame:";
    if(!$frame->get_body_by_number(0, false, 100500))
    echo "no such frame <br> <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:7010"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> frame.xxxxxxxxx </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/frame.html"), "<br> <br>")
     
    # 2
    echo("2.Get body of frame 0 as html:")
    echo(frame.get_body_by_number(0, true), "<br> <br>")
     
    # 3
    echo("3.Get body of frame 0 as text:")
    echo(frame.get_body_by_number(0, false), "<br> <br>")
     
    # 4
    echo("4.Get the body of a non-existent frame:")
    if not frame.get_body_by_number(100500, false):
    echo("no such element <br> <br>")
     
    # five
    echo("5.Get body of frame 0 as text in frame zero:")
    echo(frame.get_body_by_number(0, false, 0), "<br> <br>")
     
    # 6
    echo("6.Get the body of a nonexistent frame in frame zero:")
    if not frame.get_body_by_number(100500, false, 0):
    echo("no such element <br> <br>")
     
    # 7
    echo("7.Get the body of a frame in a nonexistent frame:")
    if not frame.get_body_by_number(0, false, 100500):
    echo("no such frame <br> <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:7010";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> frame.get_body_by_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/frame.html") + "<br> <br>");
     
    //step 2
    echo("2.Get body of frame 0 as html:");
    echo(frame.get_body_by_number(0, true) + "<br> <br>");
     
    //step 3
    echo("3.Get the body of frame 0 as text:");
    echo(frame.get_body_by_number(0, false) + "<br> <br>");
     
    //step 4
    echo("4.Get the body of a non-existent frame:");
    if(frame.get_body_by_number(100500, false) == "false")
    echo("no such element <br> <br>");
     
    //step 5
    echo("5.Get the body of frame 0 as text in frame zero:");
    echo(frame.get_body_by_number(0, false, "0") + "<br> <br>");
     
    //6 step
    echo("6.Get the body of a non-existent frame in frame zero:");
    if(frame.get_body_by_number(100500, false, "0") == "false")
    echo("no such element <br> <br>");
     
    //step 7
    echo("7.Get the body of a frame in a non-existent frame:");
    if(frame.get_body_by_number(0, false, "100500") == "false")
    echo("no such frame <br> <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> frame.get_body_by_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/frame.html") + "<br> <br>");
     
    //step 2
    echo("2.Get body length of frame 0 as html:");
    echo(frame.get_body_by_number(0, true) .length + "<br> <br>");
     
    //step 3
    echo("3.Get body length of frame 0 as text:");
    echo(frame.get_body_by_number(0, false) .length + "<br> <br>");
     
    //step 4
    echo("4.Get the body of a non-existent frame:");
    if(!frame.get_body_by_number(100500, false))
    echo("no such element <br> <br>");
     
    //step 5
    echo("5.Get body length of frame 0 as text in frame zero:");
    echo(frame.get_body_by_number(0, false, 0) .length + "<br> <br>");
     
    //step 6
    echo("6.Get the body of a non-existent frame in frame zero:");
    if(!frame.get_body_by_number(100500, false, 0))
    echo("no such element <br> <br>");
     
    //step 7
    echo("7.Get the body of a frame in a non-existent frame:");
    if(!frame.get_body_by_number(0, false, 100500))
    echo("no such frame <br> <br>");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/frame/body/get_body_by_number.txt · Last modified: 2026/08/05 22:44 (external edit)