humanemulator.net — справка.
Продукт, демо и покупка — на
хуманэмулятор.рф
|
Демо
|
Купить
|
API
|
лог изменений
is_exist_by_alt
is_exist_by_alt($alt,$exactly=true,$frame=-1); - данная функция используется для проверки наличия элемента на странице, находя его по заданному alt или его части. (Доступна с версии 4.6.3)Функция на вход принимает параметры:
С версии 4.6.41 достпуно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 достпуно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданнй src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки функция возвращает результат своей работы в скрипт (тип возвращаемого значения boolean):
Пример использования
<?php // Scenario: Demonstrate the is_exist_by_alt function for checking if DOM elements exist by their alt attribute // Connection settings to XHE server $xhe_host = getenv("RPABOT_HOST_URL"); 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 elements that have alt attributes (typically images) WEB::$browser->navigate(TEST_POLYGON_URL . "image.html"); WEB::$browser->wait_for(); // Example 1: Check if an element exists by its alt echo("Example 1: Checking if an element exists by its alt"); $elementAlt = "screenshot1"; // Alt text of an existing image // Check if element exists $exists = DOM::$element->is_exist_by_alt($elementAlt, true); // Check the result if ($exists) { echo "Element with alt '{$elementAlt}' exists.\n"; } else { echo "Element with alt '{$elementAlt}' does not exist.\n"; } // Example 3: Check if an element exists in a specific frame by contains alt echo "\n\nExample 3: Checking if an element exists in a specific frame by contains alt\n"; $elementAlt = "screenshot1"; // Alt text of an image in a frame $frameNumber = 0; // First frame // Check if element exists in frame by contains alt $exists = DOM::$element->is_exist_by_alt($elementAlt, false, $frameNumber); // Check the result if ($exists) { echo "Element contains alt '{$elementAlt}' exists in frame {$frameNumber}.\n"; } else { echo "Element contains alt '{$elementAlt}' does not exist in frame {$frameNumber}.\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.xxxxxxxxx</font><hr>") # 1 echo("1. Перейдем на полигон : ") echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/image.html"),"<br>") # 2 echo("2. Проверяем есть ли элемент с заданным alt : ") echo(image.is_exist_by_alt("screenshot",true),"\n") # 3 echo("3. Проверяем есть ли элемент с заданной частью alt : ") echo(image.is_exist_by_alt("shot 1",false),"\n") # 4 echo("4. Проверим несуществующий элемент : ") if not image.is_exist_by_alt("ptych",false): echo("element not exist<br>") # 5 echo("5. Проверяем есть ли элемент с заданным alt в нулевом фрейме : ") echo(image.is_exist_by_alt("screenshot",true,0),"\n") # 6 echo("6. Проверяем несуществующий элемент в нулевом фрейме : ") if not image.is_exist_by_alt("ptych",false,0): echo("element not exist<br>") # 7 echo("7. Проверяем есть ли картинка с alt = screenshot в несуществующем фрейме : ") if not image.is_exist_by_alt("screenshot",true,100500): echo("frame not exist<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 = Environment.GetEnvironmentVariable("RPABOT_HOST_URL"); InitXHE(); // начало echo("<hr><font color=blue>is_exist_by_alt</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("rpa-bot.ru/wiki/poligon/image.html")+"<br>"); // 2 шаг echo("2. Проверяем есть ли картинка с alt = screenshot : "); if (image.is_exist_by_alt("screenshot",true)) echo("есть<br>"); // 3 шаг echo("3. Проверяем есть ли картинка с alt, содержащим 'shot 1' : "); if (image.is_exist_by_alt("shot 1",false)) echo("есть<br>"); // 4 шаг echo("4. Проверяем есть ли картинка с alt, содержащим 'аывтара' : "); if(!image.is_exist_by_alt("аывтара",false)) echo("нет такого элемента<br>"); // 5 шаг echo("5. Проверяем есть ли картинка с alt = screenshot в нулевом фрейме : "); if (image.is_exist_by_alt("screenshot",true,"0")) echo("есть<br>"); // 6 шаг echo("6. Проверяем есть ли картинка с alt, содержащим 'аывтара' в нулевом фрейме : "); if(!image.is_exist_by_alt("аывтара",false,"0")) echo("нет такого элемента<br>"); // 7 шаг echo("7. Проверяем есть ли картинка с alt = screenshot в несуществующем фрейме : "); if (!image.is_exist_by_alt("screenshot",true,"100500")) echo("нет такого фрейма<br>"); // конец echo("\n\n"); app.quit(); } }
// IE + Chrom // подключим функциональные объекты, если еще не подключен xhe_host="127.0.0.1:7010"; echo=require("../../../Templates JS/init.js"); // начало echo("<hr><font color=blue>anchor.is_exist_by_alt</font><hr>"); // 1 шаг echo("1. Перейдем на полигон : "); echo(browser.navigate("https://rpa-bot.ru/wiki/poligon/image.html")+"<br>"); // 2 шаг echo("2. Проверяем есть ли элемент с заданным alt : "); echo(image.is_exist_by_alt("screenshot",true)+"\n"); // 3 шаг echo("3. Проверяем есть ли элемент с заданной частью alt : "); echo(image.is_exist_by_alt("shot 1",false)+"\n"); // 4 шаг echo("4. Проверим несуществующий элемент : "); if(!image.is_exist_by_alt("ptych",false)) echo("element not exist<br>"); // 5 шаг echo("5. Проверяем есть ли элемент с заданным alt в нулевом фрейме : "); echo(image.is_exist_by_alt("screenshot",true,0)+"\n"); // 6 шаг echo("6. Проверяем несуществующий элемент в нулевом фрейме : "); if(!image.is_exist_by_alt("ptych",false,0)) echo("element not exist<br>"); // 7 шаг echo("7. Проверяем есть ли картинка с alt = screenshot в несуществующем фрейме : "); if (!image.is_exist_by_alt("screenshot",true,100500)) echo("frame not exist<br>"); // конец echo("\n"); // Quit app.quit();
=============================================
Общие функции Объекты DOM System Vision Web Window
=============================================
Если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум.
PS: В тестовом примере приведена работа с конкретным объектом DOM, но данная функция есть во всех DOM объектах, т.е она существует у всех объектов из категории DOM.