form/submit_by_attribute

submit_by_attribute(attr_name, attr_value, exactly=true, frame=-1); - данная функция используется для сабмита формы на текущей странице, находя её по заданному значению атрибута или его части.

Функция на вход принимает параметры:

attr_name – имя атрибута, значение которого мы будем искать элемент на странице (string). Чтобы узнать имена атрибутов у элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.

attr_value – значение атрибута, по которому мы будем искать элемент на странице (string). Чтобы узнать значение заданного атрибута у элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.

exactly – точное соответствие значения заданного атрибута при поиске элемента (boolean), по умолчанию 1 - значение заданного атрибута элемента должно полностью совпадать с переданным параметром (attr_value), если этот параметр задан как 0, то будет найден первый элемент, где в значении заданного атрибута содержится заданная строка (attr_value).

frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.

После отработки функция возвращает результат своей работы в робот (тип возвращаемого значения boolean):

true – выполнили успешно

false – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма)

Пример использования submit_by_attribute (PHP):

<?php $xhe_host = "127.0.0.1:7094";
 
// подключим объект для управления эмулятором, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>form->".basename (__FILE__)."</font><hr>";
 
// 1 
echo "1. Перейдем на полигон для формы : ";
echo $browser->navigate("http://rbot.biz-apps.ru/poligon/form.html")."<br>";
 
// 2 
echo "2. Сабмитим элемент с action = http://www.rbot.biz-apps.ru : ";
echo $form->submit_by_attribute("action","http://www.rbot.biz-apps.ru")."<br>";
$browser->navigate("http://rbot.biz-apps.ru/poligon/form.html");
 
// 3 
echo "3. Сабмитим элемент с action содержащим .net : ";
echo $form->submit_by_attribute("action",".net",false)."<br>";
$browser->navigate("http://rbot.biz-apps.ru/poligon/form.html");
 
// 4 
echo "4. Сабмитим несуществующий элемент : ";
if (!$form->submit_by_attribute("action","ptych"))
	echo "нет такого элемента<br>";
 
// 5 
echo "5. Сабмитим элемент с action равным http://www.rbot.biz-apps.ru в нулевом фрейме : ";
echo $form->submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,0)."<br>";
$browser->navigate("http://rbot.biz-apps.ru/poligon/form.html");;
 
// 6 
echo "6. Сабмитим несуществующий элемент в нулевом фрейме : ";
if (!$form->submit_by_attribute("action","ptych",true,0))
	echo "нет такого элемента<br>";
 
// 7 
echo "7. Сабмитим элемент в несуществующем фрейме : ";
if (!$form->submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,100500))
	echo "нет такого фрейма<br>";
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>

Пример использования submit_by_attribute (C#):

#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();
 
			// начало
			echo("<hr><font color=blue>form.submit_by_attribute</font><hr>");
 
			// 1 шаг
			echo("1. Перейдем на полигон для формы : ");
			echo(browser.navigate("www.rbot.biz-apps.ru/poligon/form.html")+"<br>");
 
			// 2 шаг
			echo("2. Сабмитим элемент с action = http://www.rbot.biz-apps.ru : ");
			echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru")+"<br>");
			browser.go_back();
 
			// 3 шаг
			echo("3. Сабмитим элемент с action содержащим .net : ");
			echo(form.submit_by_attribute("action",".net",false)+"<br>");
			browser.go_back();
 
			// 4 шаг
			echo("4. Сабмитим несуществующий элемент : ");
			if (!form.submit_by_attribute("action","ptych"))
				echo("нет такого элемента<br>");
 
			// 5 шаг
			echo("5. Сабмитим элемент с action равным http://www.rbot.biz-apps.ru в нулевом фрейме : ");
			echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,"0")+"<br>");
			browser.go_back();
 
			// 6 шаг
			echo("6. Сабмитим несуществующий элемент в нулевом фрейме : ");
			if (!form.submit_by_attribute("action","ptych",true,"0"))
				echo("нет такого элемента<br>");
 
			// 7 шаг
			echo("7. Сабмитим элемент в несуществующем фрейме : ");
			if (!form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,"100500"))
				echo("нет такого фрейма<br>");
 
			// конец
			echo("<hr><br>");
 
			app.quit();            
	  }
}

Пример использования submit_by_attribute (Python):

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')
 
xhe_host = "127.0.0.1:7010"
from xweb_human_emulator import *
 
# начало
echo("<hr><font color=blue>form.xxxxxxxxx</font><hr>")
 
# 1 
echo("1. Перейдем на полигон для формы : ")
echo(browser.navigate("http://www.rbot.biz-apps.ru/poligon/form.html"),"<br>")
 
# 2 
echo("2. Сабмитим элемент с action = http://www.rbot.biz-apps.ru : ")
echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru"),"<br>")
browser.go_back()
 
# 3 
echo("3. Сабмитим элемент с action содержащим .net : ")
echo(form.submit_by_attribute("action",".net",false),"<br>")
browser.go_back()
 
# 4 
echo("4. Сабмитим несуществующий элемент : ")
if not form.submit_by_attribute("action","ptych"):
	echo("нет такого элемента<br>")
 
# 5 
echo("5. Сабмитим элемент с action равным http://www.rbot.biz-apps.ru в нулевом фрейме : ")
echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,0),"<br>")
browser.go_back()
 
# 6 
echo("6. Сабмитим несуществующий элемент в нулевом фрейме : ")
if not form.submit_by_attribute("action","ptych",true,0):
	echo("нет такого элемента<br>")
 
# 7 
echo("7. Сабмитим элемент в несуществующем фрейме : ")
if not form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,100500):
	echo("нет такого фрейма<br>")
 
# конец
echo("<hr><br>")
 
# Quit
app.quit()

Пример использования submit_by_attribute (JS):

// подключим объект для управления эмулятором, если еще не подключен
xhe_host="127.0.0.1:7010";
echo=require("../../../Templates JS/init.js");
 
// начало
echo("<hr><font color=blue>form.submit_by_attribute</font><hr>");
 
// 1 шаг
echo("1. Перейдем на полигон для формы : ");
echo(browser.navigate("http://www.rbot.biz-apps.ru/poligon/form.html")+"<br>");
 
// 2 шаг
echo("2. Сабмитим элемент с action = http://www.rbot.biz-apps.ru : ");
echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru")+"<br>");
browser.go_back();
 
// 3 шаг
echo("3. Сабмитим элемент с action содержащим .net : ");
echo(form.submit_by_attribute("action",".net",false)+"<br>");
browser.go_back();
 
// 4 шаг
echo("4. Сабмитим несуществующий элемент : ");
if (!form.submit_by_attribute("action","ptych"))
	echo("нет такого элемента<br>");
 
// 5 шаг
echo("5. Сабмитим элемент с action равным http://www.rbot.biz-apps.ru в нулевом фрейме : ");
echo(form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,0)+"<br>");
browser.go_back();
 
// 6 шаг
echo("6. Сабмитим несуществующий элемент в нулевом фрейме : ");
if (!form.submit_by_attribute("action","ptych",true,0))
	echo("нет такого элемента<br>");
 
// 7 шаг
echo("7. Сабмитим элемент в несуществующем фрейме : ");
if (!form.submit_by_attribute("action","http://www.rbot.biz-apps.ru",true,100500))
	echo("нет такого фрейма<br>");
 
// конец
echo("<hr><br>");
 
// Quit
app.quit();