Справка Human Emulator общее DOM: get_by

get_by_value

get_by_value($value,$exactly=true,$frame=-1); - данная функция используется для получения DOM интерфейса элемента страницы, находя его по заданному value.

Доступна с версии 4.6.31

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

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

$exactly – точное соответствие value при поиске элемента (boolean), по умолчанию 1 - value элемента должен полностью совпадать с переданным параметром ($value), если этот параметр задан как 0, то будет найден первый элемент в value которого содержится заданная строка ($value). Начиная с версии 7.0.25 можно пердавать значение 2, тогда value будет восприниматься как регулярное выражение для функции Java Script String.search.

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

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

DOM интерфейс элемента – объект позволяющий быстро выполнять любые операции с найденным элементом, тип возвращаемого значения XHEInterface

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

Интерфейс

get_by_value