send_event_by_inner_text(inner_text, exactly, event, frame=-1,
wait_browser=true)
Данная команда используется для передачи события элементу страницы, находя его
по заданному внутреннему тексту или его части.
Команда на вход принимает параметры:
-
inner_text - внутренний текст по
которому мы находим необходимый нам элемент на странице (string). Чтобы
узнать внутренний текст элемента, можно воспользоваться либо инспектором
элементов, либо контекстным меню, либо посмотреть его в списке элементов.
-
exactly - точное соответствие
внутреннего текста при поиске элемента (boolean), по умолчанию 1 -
внутренний текст элемента должен полностью совпадать с переданным параметром
($inner_text), если этот параметр задан как 0, то будет найден первый
элемент во внутренним тексте которого содержится заданная строка
($inner_text).
-
event - событие, которое будет
послано найденному элементу (string). Например "onmousemove", "onchange", "onkeydown", "onkeyup" и т.п. Полный список событий
и их описаний можно найти например здесь.
-
wait_browser - проверять и ждать
окончания навигации
-
frame - номер фрейма, в котором мы
ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 -
элемент находится не во фрейме. Номер фрейма в котором находится нужный вам
элемент можно узнать из инспектора задач, контекстного меню и панели списка
элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой
же самый, передается строка с номерами фреймов, разделенных : например при
передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером
0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет
произведен поиск фрейма, который содержит заданный src, или передавать
"name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки команда возвращает результат своей работы в робот:
-
true - выполнили успешно
-
false - найти такой
элемент не удалось (например нет вообще элементов, удовлетворяющих заданным
критериям или нет такого фрейма)