get_by_id(id, exactly=true, frame=-1);
Данная команда используется для получения DOM интерфейса элемента страницы, находя его по заданному id.
Команда на вход принимает параметры:
- id – id по которому мы находим необходимый нам элемент на странице (string). Чтобы узнать id элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
- exactly – точное соответствие id при поиске элемента (boolean), по умолчанию true - id элемента должен полностью совпадать с переданным параметром (id), если этот параметр задан как false, то будет найден первый элемент в id которого содержится заданная строка (id).
- frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.
После отработки команда возвращает результат своей работы в робот:
- DOM интерфейс элемента - объект позволяющий быстро выполнять любые операции с найденным элементом, тип возвращаемого значения rBotInterface