humanemulator.net — справка.
Продукт, демо и покупка — на
хуманэмулятор.рф
|
Демо
|
Купить
|
API
|
лог изменений
click_by_attribute
click_by_attribute($attr_name,$attr_value,$exactly=true,$frame=-1,$wait_browser=true); - данная функция используется для эмуляции клика мышки по элементу страницы, находя его по заданному значению аттрибута или его части.Функция на вход принимает параметры:
С версии 4.6.41 достпуно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 достпуно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданнй src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки функция возвращает результат своей работы в скрипт (тип возвращаемого значения boolean):
Пример использования
<?php // Scenario: Click on a DOM element by its attribute $xhe_host = "localhost:7010"; if (!isset($path)){ // Path to the init.php file for connecting to the XHE API $path = "../../../Templates/init.php"; // Including init.php grants access to all classes and functionality for working with the XHE API require($path); } // Navigate to a webpage with anchor elements WEB::$browser->navigate(TEST_POLYGON_URL . "image.html"); // Example 1: Click on an image by attribute (partial match) $clickResult = DOM::$image->click_by_attribute("alt", "screenshot", false); echo "Click result (partial match): " . ($clickResult ? "Success" : "Failed") . "\n"; // Example 2: Click on an image by attribute (exact match) $clickResult = DOM::$image->click_by_attribute("alt", "screenshot1", true); echo "Click result (exact match): " . ($clickResult ? "Success" : "Failed") . "\n"; // Example 3: Click on an image by attribute within a specific frame // First, let's check if we have frames on the page $framesCount = DOM::$frame->get_count(); if ($framesCount > 0) { // Click on an image by attribute within the first frame (frame=0) $clickResult = DOM::$image->click_by_attribute("alt", "screenshot", false, 0); echo "Click result in frame 0: " . ($clickResult ? "Success" : "Failed") . "\n"; } else { echo "No frames found on the page\n"; } // Quit the application WINDOW::$app->quit();
# 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>common.click_by_attribute</font><hr>") # 1 echo("1. Перейдем на полигон : ") echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/anchor.html"),"<br>") # 2 echo("2. Кликнем на элементе с name = list : ") echo(anchor.click_by_attribute("name","list"),"<br>") # 3 echo("3. Кликнем на элементе с class содержащим r : ") echo(anchor.click_by_attribute("class","r",false),"<br>") # 4 echo("4. Кликнем на несуществующем элементе : ") if not anchor.click_by_attribute("name","list_ret",false): echo("нет такого элемента<br>") # 5 echo("5. Перейдем на полигон : ") echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/anchor.html"),"<br>") # 6 echo("6. Кликнем на элементе с name = list в нулевом фрейме : ") echo(anchor.click_by_attribute("name","list",true,0),"<br>") # 7 echo("7. Кликнем на элементе с class содержащим r в нулевом фрейме : ") echo(anchor.click_by_attribute("class","r",false,0),"<br>") # 8 echo("8. Кликнем на несуществующем элементе в нулевом фрейме : ") if not anchor.click_by_attribute("name","list_ret",false,0): echo("нет такого элемента<br>") # 9 echo("9. Кликнем на элементе в несуществующем фрейме : ") if not anchor.click_by_attribute("name","list",false,5): echo("нет такого фрейма<br>") # конец echo("<hr><br>") # Quit app.quit()
#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 = "localhost:7010"; InitXHE(); // начало echo("<hr><font color=blue>click_by_attribute</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("rpa-bot.ru/wiki/poligon/anchor.html")+"<br>"); // 2 шаг echo("2. Кликнем на элементе с name = list : "); echo(anchor.click_by_attribute("name","list")+"<br>"); // 3 шаг echo("3. Кликнем на элементе с class содержащим r : "); echo(anchor.click_by_attribute("class","r",false)+"<br>"); // 4 шаг echo("4. Кликнем на несуществующем элементе : "); if(!anchor.click_by_attribute("name","list_ret1",false)) echo("нет такого элемента<br>"); // 5 шаг echo("5. Перейдем на полигон : "); echo(browser.navigate("rpa-bot.ru/wiki/poligon/anchor.html")+"<br>"); // 6 шаг echo("6. Кликнем на элементе с name = list в нулевом фрейме : "); echo(anchor.click_by_attribute("name","list",true,"0")+"<br>"); // 7 шаг echo("7. Кликнем на элементе с class содержащим r в нулевом фрейме : "); echo(anchor.click_by_attribute("class","r",false,"0")+"<br>"); // 8 шаг echo("8. Кликнем на несуществующем элементе в нулевом фрейме : "); if(!anchor.click_by_attribute("name","list_ret",false,"0")) echo("нет такого элемента<br>"); // 9 шаг echo("9. Кликнем на элементе в несуществующем фрейме : "); if(!anchor.click_by_attribute("name","list",false,"5")) echo("нет такого фрейма<br>"); // конец echo("\n\n"); app.quit(); } }
// IE + Chrom // подключим функциональные объекты, если еще не подключен xhe_host="127.0.0.1:7013"; echo=require("../../../Templates JS/init.js"); // начало echo("<hr><font color=blue>anchor.click_by_attribute</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/anchor.html")+"<br>"); // 2 шаг echo("2. Кликнем на элементе с name = list : "); echo(anchor.click_by_attribute("name","list")+"<br>"); // 3 шаг echo("3. Кликнем на элементе с class содержащим r : "); echo(anchor.click_by_attribute("class","r",false)+"<br>"); // 4 шаг echo("4. Кликнем на несуществующем элементе : "); if(!anchor.click_by_attribute("name","list_ret",false)) echo("нет такого элемента<br>"); // 5 шаг echo("5. Перейдем на полигон : "); echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/anchor.html")+"<br>"); // 6 шаг echo("6. Кликнем на элементе с name = list в нулевом фрейме : "); echo(anchor.click_by_attribute("name","list",true,0)+"<br>"); // 7 шаг echo("7. Кликнем на элементе с class содержащим r в нулевом фрейме : "); echo(anchor.click_by_attribute("class","r",false,0)+"<br>"); // 8 шаг echo("8. Кликнем на несуществующем элементе в нулевом фрейме : "); if(!anchor.click_by_attribute("name","list_ret",false,0)) echo("нет такого элемента<br>"); // 9 шаг echo("9. Кликнем на элементе в несуществующем фрейме : "); if(!anchor.click_by_attribute("name","list",false,5)) echo("нет такого фрейма<br>"); // конец echo("\n"); // Quit app.quit();
=============================================
Общие функции Объекты DOM System Vision Web Window
=============================================
Если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум.
PS: В тестовом примере приведена работа с конкретным объектом DOM, но данная функция есть во всех DOM объектах, т.е она существует у всех объектов из категории DOM.