Geometry

public class Geometry

Added in version 1.2.0.

Added in version 1.2.2: Добавлен getScrollBarRect(WithWebElement, boolean).

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

Methods

getBoundingClientRect

public BoundingClientRect getBoundingClientRect(WithWebElement withWebElement)

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

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

Parameters:
  • withWebElement – объект, содержащий веб-элемент, для которого нужно получить координаты и размеры.

Returns:

Объект BoundingClientRect, содержащий все данные о положении и размере веб-элемента.

getBoundingClientRect

public BoundingClientRect getBoundingClientRect(WebElement webElement)

Added in version 1.2.3.

Получить положение и размер dom-элемента относительно области просмотра.

Parameters:
  • webElement – dom-элемент

Returns:

положение и размер элемента

getScrollBarRect

public BoundingClientRect getScrollBarRect(WithWebElement container, boolean isVertical)

Added in version 1.2.2.

Получить положение и размер нативной полосы прокрутки контейнера в окне браузера.

Нативная полоса не отдельный dom-элемент, и getBoundingClientRect() для неё не вызвать. Прямоугольник вычисляется из прямоугольника контейнера, его видимой области и рамки. Вертикальная полоса лежит справа от видимой области, горизонтальная - под ней. Все величины читаются за одно обращение к браузеру, чтобы между чтениями не вклинилась перерисовка. У полосы, которая не занимает места (наложенной поверх содержимого или скрытой стилями), толщина прямоугольника равна 0.

Parameters:
  • container – объект с dom-элементом, содержимое которого прокручивается

  • isVertical – true для вертикальной полосы, false для горизонтальной

Returns:

прямоугольник полосы прокрутки

getWindowHeight

public int getWindowHeight()

Added in version 1.2.1.

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

В отличие от WebDriver.Window.getSize() → Dimension.getHeight(), этот метод использует JavaScript и возвращает именно высоту внутренней области окна (без учета рамок, панели инструментов и т.д.).

Returns:

высота viewport (innerHeight) текущего окна браузера.

getWindowWidth

public int getWindowWidth()

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

В отличие от WebDriver.Window.getSize() → Dimension.getWidth(), этот метод использует JavaScript и возвращает именно ширину внутренней области окна (без учета рамок, панели инструментов и т.д.).

Returns:

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

of

public static Geometry of(BrowserContext ctx)