====== z_number_res_dom_element ======

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

[[objects:start|← Objects]]

----

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

* номер элемента – номер найденного элемента (нумерация элементов начинается с нуля), тип возвращаемого значения string

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

**О значении.** Результат — порядковый номер найденного элемента на странице, начиная с нуля. Номер используют, чтобы затем обращаться к элементу по номеру.

Это значение возвращают функции: <code>get_number</code>, <code>get_number_by_attribute</code>, <code>get_number_by_href</code>, <code>get_number_by_id</code>, <code>get_number_by_inner_html</code>, <code>get_number_by_inner_text</code>, <code>get_number_by_name</code>, <code>get_number_by_src</code> (группа <code>get</code>).

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