.. java:import:: ru.bitec.gs.automation.client BrowserContext

.. java:import:: ru.bitec.gs.automation.client WithWebElement

Geometry
========

.. java:package:: ru.bitec.gs.automation.client.html.geometry
   :noindex:

.. java:type:: public class Geometry

   .. versionadded:: 1.2.0

   Набор вспомогательных средств для взаимодействия с геометрическими характеристиками окна браузера и веб-элементов.

Methods
-------

getBoundingClientRect
^^^^^^^^^^^^^^^^^^^^^

.. java:method:: public BoundingClientRect getBoundingClientRect(WithWebElement withWebElement)
   :outertype: Geometry

   Получает информацию о положении и размере веб-элемента на экране.

   Внутри метод запускает JavaScript-функцию ``element.getBoundingClientRect()``
   прямо в браузере. Эта функция возвращает координаты (x, y) и размеры
   (ширину и высоту) веб-элемента, а также расстояния от границ окна браузера
   (viewport) до сторон веб-элемента.

   :param withWebElement: объект, содержащий веб-элемент, для которого нужно получить координаты и размеры.
   :return: Объект :java:ref:`BoundingClientRect <ru.bitec.gs.automation.client.html.geometry.BoundingClientRect>`, содержащий все данные о положении и размере веб-элемента.

getWindowWidth
^^^^^^^^^^^^^^

.. java:method:: public int getWindowWidth()
   :outertype: Geometry

   Возвращает ширину видимой области (viewport) окна браузера в пикселях.

   В отличие от :java:ref:`WebDriver.Window.getSize() <org.openqa.selenium.WebDriver.Window.getSize()>` → :java:ref:`Dimension.getWidth() <org.openqa.selenium.Dimension.getWidth()>`,
   этот метод использует JavaScript и возвращает именно ширину внутренней
   области окна (без учета рамок, панели инструментов и т.д.).

   :return: ширина viewport (innerWidth) текущего окна браузера.

of
^^

.. java:method:: public static Geometry of(BrowserContext ctx)
   :outertype: Geometry