====== z_y_res_dom_element ======

**Каноническая страница:** [[https://humanemulator.net/objects/z_y_res_dom_element.php|https://humanemulator.net/objects/z_y_res_dom_element.php]]

[[objects:start|← Objects]]

----

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

* y-координата – y-координата левого верхнего угла элемента, относительно левого верхнего угла браузера + элементов контейнеров, если они есть, тип возвращаемого значения string

* -1 – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма), тип возвращаемого значения int

**О значении.** Результат — y-координата левого верхнего угла элемента относительно левого верхнего угла браузера с учётом элементов-контейнеров. Вместе с x-координатой задаёт точку элемента на экране для наведения мыши.

Это значение возвращают функции: <code>get_y_by_attribute</code>, <code>get_y_by_href</code>, <code>get_y_by_inner_html</code>, <code>get_y_by_inner_text</code>, <code>get_y_by_name</code>, <code>get_y_by_number</code>, <code>get_y_by_tag_by_number</code> (группа <code>get_xy</code>).

Результат возвращается в скрипт, и его можно сохранить в переменную, чтобы использовать в следующих шагах. Если вместо значения возвращается признак ошибки, элемент не найден — поэтому перед обращением к данным результат полезно проверить.