• EN
    RU

DOM общее для всех/click_by_alt

click_by_alt(alt, exactly=true, frame=-1, wait_browser=true); - данная функция используется для эмуляции клика мышки по элементу страницы, находя его по заданному alt или его части.
Функция на вход принимает параметры:
  • alt – alt по которому мы находим необходимый нам элемент на странице (string). Чтобы узнать alt элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
  • exactly – точное соответствие alt при поиске элемента (boolean), по умолчанию 1 - alt элемента должен полностью совпадать с переданным параметром (alt), если этот параметр задан как 0, то будет найден первый элемент в alt которого содержится заданная строка (alt). Начиная с версии 7.0.25 можно передавать значение 2, тогда alt будет восприниматься как регулярное выражение для функции Java Script String.search.
  • wait_browser – проверять и ждать окончания навигации (доступен с версии 7.0.21)
  • frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
    С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
    С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.


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