Каноническая страница: https://humanemulator.net/objects/z_y_res_dom_element.php
После отработки функция возвращает результат своей работы в скрипт :
* y-координата – y-координата левого верхнего угла элемента, относительно левого верхнего угла браузера + элементов контейнеров, если они есть, тип возвращаемого значения string
* -1 – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма), тип возвращаемого значения int
О значении. Результат — y-координата левого верхнего угла элемента относительно левого верхнего угла браузера с учётом элементов-контейнеров. Вместе с x-координатой задаёт точку элемента на экране для наведения мыши.
Это значение возвращают функции:
get_y_by_attribute
,
get_y_by_href
,
get_y_by_inner_html
,
get_y_by_inner_text
,
get_y_by_name
,
get_y_by_number
,
get_y_by_tag_by_number
(группа
get_xy
).
Результат возвращается в скрипт, и его можно сохранить в переменную, чтобы использовать в следующих шагах. Если вместо значения возвращается признак ошибки, элемент не найден — поэтому перед обращением к данным результат полезно проверить.