components package

Submodules

components.alert_component module

Модуль для работы с компонентом alert-окна в Playwright.

Содержит класс AlertComponent для взаимодействия с различными типами alert-окон (error, success, info, warning) и проверки их состояния.

class AlertComponent(page)

Базовые классы: BaseComponent

Компонент для работы с alert-окнами Playwright.

Поддерживает типы: error, success, info, warning. Позволяет проверять наличие, отсутствие и текст сообщений.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент alert-окна.

Параметры:

page (Page) – Экземпляр страницы Playwright.

Тип результата:

None

close_alert_by_text(text)

Закрывает alert-окно с заданным текстом с помощью кнопки закрытия.

Параметры:

text (str) – Текст alert-окна, которое нужно закрыть.

Исключение:

AssertionError – Если не удалось найти или закрыть alert-окно.

Тип результата:

None

get_alert_type()

Возвращает тип alert-окна.

Результат:

Тип alert-окна.

Тип результата:

str

Исключение:

ValueError – Если получен неподдерживаемый тип alert-окна.

get_text()

Возвращает текст сообщения из alert-окна.

Результат:

Текст сообщения.

Тип результата:

str

check_alert_absence(text, timeout=30000)

Проверяет отсутствие alert-окна с заданным текстом.

Параметры:

• text (str) – Текст для проверки.

• timeout (int) – Время ожидания исчезновения (мс).

Исключение:

AssertionError – Если окно не исчезает в течение заданного времени.

Тип результата:

None

check_alert_presence(text)

Проверяет наличие alert-окна с заданным текстом.

Параметры:

text (str) – Текст для проверки. Если пустая строка - проверяет только наличие окна.

Исключение:

AssertionError – Если alert-окно не найдено.

Тип результата:

None

check_text(alert_text)

Проверяет точное соответствие текста в alert-окне.

Параметры:

alert_text (str) – Ожидаемый текст сообщения.

Исключение:

AssertionError – Если текст не соответствует ожидаемому.

Тип результата:

None

components.base_component module

Базовый модуль для работы с компонентами страницы.

Содержит базовый класс для взаимодействия с элементами страницы через Playwright.

class BaseComponent(page)

Базовые классы: object

Базовый компонент для работы с элементами страницы.

Предоставляет общие методы для взаимодействия с элементами: - получение локаторов - проверка видимости элементов - работа с прокруткой

Параметры:

page (Page)

__init__(page)

Инициализация базового компонента.

Параметры:

page (Page) – экземпляр страницы Playwright.

get_locator(locator)

Получение объекта Locator из строки или существующего Locator.

Параметры:

locator (str | Locator) – строка с CSS/XPath селектором или объект Locator.

Результат:

объект для работы с элементом.

Тип результата:

Locator

Исключение:

TypeError – если передан некорректный тип локатора.

check_absence(locator, msg)

Проверка отсутствия элемента на странице.

Параметры:

• locator (str | Locator) – локатор элемента (строка или объект Locator).

• msg (str) – сообщение об ошибке при неудачной проверке.

Исключение:

AssertionError – если элемент виден на странице.

Тип результата:

None

check_visibility(locator, msg)

Проверка видимости элемента на странице.

Параметры:

• locator (str | Locator) – локатор элемента (строка или объект Locator).

• msg (str) – сообщение об ошибке при неудачной проверке.

Исключение:

AssertionError – если элемент не виден на странице.

Тип результата:

None

is_scrollable_vertically(locator)

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

Параметры:

locator (str | Locator) – локатор элемента.

Результат:

True если элемент можно прокрутить вертикально.

Тип результата:

bool

is_scrollable_horizontally(locator)

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

Параметры:

locator (str | Locator) – локатор элемента.

Результат:

True если элемент можно прокрутить горизонтально.

Тип результата:

bool

scroll_up(locator, timeout=10000)

Прокрутка элемента до самого верха.

Параметры:

• locator (str | Locator) – локатор элемента.

• timeout (int) – максимальное время ожидания в мс.

Исключение:

AssertionError – если прокрутка не выполнена до верха.

Тип результата:

None

scroll_down(locator, timeout=10000)

Прокрутка элемента до самого конца.

Параметры:

• locator (str | Locator) – локатор элемента.

• timeout (int) – максимальное время ожидания в мс.

Исключение:

AssertionError – если прокрутка не выполнена до конца.

Тип результата:

None

scroll_left(locator, timeout=10000)

Прокрутка элемента до самого левого края.

Параметры:

• locator (str | Locator) – локатор элемента.

• timeout (int) – максимальное время ожидания в мс.

Исключение:

AssertionError – если прокрутка не выполнена до левого края.

Тип результата:

None

scroll_right(locator, timeout=10000)

Прокрутка элемента до самого правого края.

Параметры:

• locator (str | Locator) – локатор элемента.

• timeout (int) – максимальное время ожидания в мс.

Исключение:

AssertionError – если прокрутка не выполнена до правого края.

Тип результата:

None

components.card_component module

Модуль компонента карточки пользователя.

Содержит класс для работы с карточкой пользователя через Playwright.

class CardComponent(page)

Базовые классы: BaseComponent

Компонент карточки пользователя.

Предоставляет методы для взаимодействия с элементами карточки.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент карточки пользователя.

Параметры:

page (Page) – Экземпляр страницы Playwright.

click_logout_button()

Нажимает кнопку выхода из системы.

Выполняет клик по кнопке „Выйти“ в карточке пользователя.

components.confirm_component module

Модуль компонента окна подтверждения действий.

Содержит класс ConfirmComponent для взаимодействия с окном подтверждения, включая кнопки подтверждения, отмены и закрытия, а также проверки текста.

class ConfirmComponent(page, cancel_button_text, allow_button_text)

Базовые классы: BaseComponent

Компонент окна подтверждения действий.

Параметры:

• page (Page)

• cancel_button_text (str)

• allow_button_text (str)

__init__(page, cancel_button_text, allow_button_text)

Инициализация компонента.

Параметры:

• page (Page) – Экземпляр страницы Playwright.

• cancel_button_text (str) – Текст кнопки отмены.

• allow_button_text (str) – Текст кнопки подтверждения.

click_allow_button()

Нажимает кнопку подтверждения действия.

Тип результата:

None

click_cancel_button()

Нажимает кнопку отмены действия.

Тип результата:

None

click_close_button()

Нажимает кнопку закрытия окна подтверждения.

Тип результата:

None

scroll_window_left()

Прокручивает содержимое окна влево.

Тип результата:

None

scroll_window_right()

Прокручивает содержимое окна вправо.

Тип результата:

None

check_title(title, msg)

Проверяет текст заголовка окна подтверждения.

Параметры:

• title (str) – Ожидаемый текст заголовка.

• msg (str) – Сообщение при ошибке.

Тип результата:

None

check_text(text, msg)

Проверяет текст сообщения в окне подтверждения.

Параметры:

• text (str) – Ожидаемый текст сообщения.

• msg (str) – Сообщение при ошибке.

Тип результата:

None

check_window_horizontal_scrolling()

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

Тип результата:

bool

should_be_cancel_button()

Проверяет наличие и видимость кнопки Отмены.

Тип результата:

None

should_be_allow_button()

Проверяет наличие и видимость кнопки Подтверждения.

Тип результата:

None

check_cancel_button_text(expected_text)

Проверяет текст кнопки Отмены.

Параметры:

expected_text (str)

Тип результата:

None

check_allow_button_text(expected_text)

Проверяет текст кнопки Подтверждения.

Параметры:

expected_text (str)

Тип результата:

None

components.date_picker_component module

Модуль компонента средства выбора даты.

Содержит класс для работы с средством выбора даты через Playwright.

class DatePickerComponent(page)

Базовые классы: BaseComponent

Компонент средства выбора даты.

Предоставляет методы для взаимодействия с элементами средства выбора даты.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент средства выбора даты.

Параметры:

page (Page) – Экземпляр страницы Playwright.

click_prev_month_button()

Нажатие на кнопку перехода к предыдущему месяцу (стрелочка влево).

Тип результата:

None

click_next_month_button()

Нажатие на кнопку перехода к следующему месяцу (стрелочка вправо).

Тип результата:

None

click_year_button()

Нажатие на кнопку текущего значения года в заголовке средства выбора даты.

Тип результата:

None

get_year()

Получение текущего значения года из заголовка средства выбора даты.

Тип результата:

str

get_month_year()

Получение текущего значения месяца и года.

Тип результата:

str

get_day()

Получение текущего номера дня.

Тип результата:

str

select_day(day)

Выбор дня месяца по его номеру.

Параметры:

day (str)

Тип результата:

None

select_year_and_month(year, month)

Выбор года и месяца по заданным значениям. Значения должны быть в формате гггг и мм

Параметры:

• year (str)

• month (str)

Тип результата:

None

check_prev_month_button_visibility()

Проверка видимости кнопки перехода к предыдущему месяцу (стрелочка влево).

Тип результата:

None

check_next_month_button_visibility()

Проверка видимости кнопки перехода к следующему месяцу (стрелочка вправо).

Тип результата:

None

check_year_button_visibility()

Проверка видимости кнопки текущего значения года в заголовке средства выбора даты.

Тип результата:

None

check_content()

Проверка состава компонент средства выбора даты.

Тип результата:

None

_is_leap_year(year)

Проверка является ли год високосным.

Параметры:

year (str)

Тип результата:

bool

components.dropdown_list_component module

Модуль dropdown_list_component содержит класс для работы с выпадающими списками.

Класс DropdownList наследует базовый функционал BaseComponent и добавляет методы для взаимодействия с выпадающими списками на странице.

class DropdownList(page)

Базовые классы: BaseComponent

Класс для работы с выпадающими списками.

Наследует функциональность BaseElement и добавляет специфичные методы для выбора и проверки элементов списка.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент выпадающего списка.

Параметры:

page (Page) – Экземпляр страницы Playwright.

Тип результата:

None

click_item_with_text(text)

Выбирает элемент списка по указанному тексту.

Параметры:

text (str) – Текст элемента для выбора.

Тип результата:

None

get_combobox_options(combobox_locator, listbox_locator, icon_locator=None)

Получает список доступных опций из combobox.

Параметры:

• combobox_locator (str | Locator) – Локатор combobox

• listbox_locator (str | Locator) – Локатор выпадающего списка

• icon_locator (str | Locator) – Локатор иконки для клика (опционально)

Результат:

Список доступных опций

Тип результата:

list[str]

get_item_names(locator)

Возвращает тексты всех элементов по указанному локатору.

Параметры:

locator (str | Locator) – Локатор элементов или строка с CSS/XPath.

Результат:

Список текстов элементов.

Тип результата:

list[str]

get_selected_combobox_value(combobox_locator, value_locator=None)

Получает выбранное значение из combobox.

Параметры:

• combobox_locator (str | Locator) – Локатор combobox

• value_locator (str | Locator) – Локатор элемента с выбранным значением (опционально)

Результат:

Выбранное значение или пустая строка если ничего не выбрано

Тип результата:

str

open_combobox(combobox_locator, listbox_locator, icon_locator=None)

Открывает выпадающий список combobox.

Параметры:

• combobox_locator (str | Locator) – Локатор combobox

• listbox_locator (str | Locator) – Локатор выпадающего списка

• icon_locator (str | Locator) – Локатор иконки для клика (опционально)

Тип результата:

None

scroll_until_end(locator)

Скроллит список до тех пор, пока не перестанут подгружаться новые элементы.

Параметры:

locator (str | Locator) – Локатор элементов или строка с CSS/XPath.

Тип результата:

None

check_item_with_text(text)

Проверяет наличие и доступность элемента списка.

Параметры:

text (str) – Текст элемента для проверки.

Исключение:

AssertionError – Если элемент отсутствует или недоступен.

Тип результата:

None

check_vertical_scrolling(locator)

Проверяет функцию вертикального скроллинга списка.

Параметры:

locator (str | Locator) – Локатор элементов или строка с CSS/XPath.

Результат:

True или False значение в зависимости от скроллируемый список или нет.

Тип результата:

bool

components.eventbar_component module

Модуль компонента панели событий. Содержит класс для работы с элементами панели.

class EventPanelComponent(page)

Базовые классы: BaseComponent

Компонент панели событий. Предоставляет методы для взаимодействия с ней.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент панели событий.

Параметры:

page (Page) – Экземпляр страницы Playwright.

click_expand_less_button()

Выполняет нажатие кнопки галочка вверх.

Тип результата:

None

click_expand_more_button()

Выполняет нажатие кнопки галочка вниз.

Тип результата:

None

click_system_log_tab()

Выполняет нажатие tab-кнопки Системный журнал.

Тип результата:

SystemLogEventsContainer

click_user_button()

Выполняет нажатие кнопки пользователя.

Тип результата:

UserCard

do_logout()

Выполняет выход из системы.

Тип результата:

None

get_event_tooltip_texts()

Возвращает список текстов всплывающих подсказок кнопок счетчиков событий.

Тип результата:

[]

get_event_button_values()

Возвращает набор значений кнопок счетчиков событий.

Тип результата:

{}

get_panel_position()

Возвращает текущее положение панели событий относительно страницы: «top», «center»,»bottom».

Тип результата:

str

check_expand_less_button()

Проверяет наличие кнопки галочка вверх.

Тип результата:

bool

check_expand_more_button()

Проверяет наличие кнопки галочка вниз

Тип результата:

bool

should_be_user_button()

Проверяет наличие кнопки пользователя.

Тип результата:

None

should_be_search_button()

Проверяет наличие кнопки поиска.

Тип результата:

None

should_be_tab_buttons()

Проверяет наличие блока tab-кнопок Состояния, Действия, События, Обслуживание, Системный журнал.

Тип результата:

None

should_be_event_buttons()

Проверяет наличие блока кнопок-счетчиков событий.

Тип результата:

None

components.events_container_component module

Модуль компонента контейнера с перечнем событий. Содержит класс для работы с контейнерами, их элементами и проверками.

class EventsContainerComponent(page, locator)

Базовые классы: BaseComponent

Компонент контейнера с перечнем событий. Предоставляет методы для взаимодействия с контейнером, его содержимым и проверок.

Параметры:

• page (Page)

• locator (str | Locator)

__init__(page, locator)

Инициализирует базовый контейнер.

Параметры:

• page (Page) – Экземпляр страницы Playwright

• locator (str | Locator) – Локатор контейнера (строка или объект Locator)

add_tab_to_toolbar(locator, name)

Добавление кнопки типа v-tabs к тулбару

Параметры:

• locator (str | Locator)

• name (str)

Тип результата:

None

click_chevron_left()

Нажатие кнопки получения предыдущего набора данных

Тип результата:

None

click_chevron_right()

Нажатие кнопки получения следующего набора данных

Тип результата:

None

click_first_page()

Нажатие кнопки перехода на первую сраницу

Тип результата:

None

click_last_page()

Нажатие кнопки перехода на последнюю страницу

Тип результата:

None

click_filter_button()

Нажатие кнопки перехода на первую сраницу

Тип результата:

SidebarFilterComponent

click_event_table_header_arrow(index)

Нажатие кнопки-стрелочки вверх/вниз в ячейке заголовка таблицы

Параметры:

index (int) – Индекс ячейки в заголовке.

Тип результата:

None

get_current_data_set_number()

Получение номера текущего набора данных

Тип результата:

int

get_arrow_button_state(index)

Получение состояния кнопки-стрелочки вверх/вниз в ячейке заголовка таблицы

Параметры:

index (int) – Индекс ячейки в заголовке.

Результат:

up, если это стрелочка вверх. down, если это стрелочка вниз.

Тип результата:

str

get_events_table_content()

Возвращает содержимое таблицы, включая заголовки.

Результат:

Двумерный список с содержимым таблицы.

Тип результата:

list[list[str]]

get_events_table_rows_count()

Возвращает количество строк в таблице (без заголовка).

Результат:

Количество строк с данными.

Тип результата:

int

Исключение:

AssertionError – Если таблица пуста.

get_sidebar_filter()

Возвращает боковую панель фильтрации.

Тип результата:

SidebarFilterComponent

get_toolbar_filter_button()

Возвращает кнопку фильтрации.

Тип результата:

Button

get_toolbar_export_to_csv_button()

Возвращает кнопку экспорта в csv.

Тип результата:

TooltipButton

get_toolbar_export_to_pdf_button()

Возвращает кнопку экспорта в pdf.

Тип результата:

TooltipButton

get_toolbar_tab_button(name)

Возвращает кнопку типа v-tabs по имени.

Параметры:

name (str)

Тип результата:

TabButton

scroll_events_table_up()

Прокручивает таблицу событий вверх.

Тип результата:

None

scroll_events_table_down()

Прокручивает таблицу событий вниз.

Тип результата:

None

check_events_table_headers(actual_headers, expected_headers)

Проверка соответствия заголовка таблицы ожидаемому

Тип результата:

None

check_events_table_column_descending_order(index, convert2timestamp=False)

Проверка, что заданный столбец таблицы упорядочен по убыванию.

Параметры:

• index (int) – Индекс столбца.

• convert2timestamp – Конвертировать строковое представление даты и времени в Unix timestamp.

Результат:

False

Тип результата:

True, если столбец таблицы упорядочен по убыванию. Иначе

check_events_table_row_highlighting(row_index)

Проверяет выделение указанной строки таблицы.

Параметры:

row_index (int) – Индекс проверяемой строки.

Исключение:

AssertionError – Если строка не выделена.

Тип результата:

None

check_events_table_first_row_visibility()

Проверяет видимость первой строки таблицы.

Исключение:

AssertionError – Если строка не видна.

Тип результата:

None

check_events_table_last_row_visibility()

Проверяет видимость последней строки таблицы.

Исключение:

AssertionError – Если строка не видна.

Тип результата:

None

check_events_table_verticall_scrolling()

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

Результат:

True если прокрутка возможна, иначе False.

Тип результата:

bool

is_chevron_left_disabled()

Проверка видимости кнопки получения предыдущего набора данных

Тип результата:

bool

is_chevron_right_disabled()

Проверка видимости кнопки получения следующего набора данных

Тип результата:

bool

is_first_page_disabled()

Проверка видимости кнопки получения первой страницы с набором данных

Тип результата:

bool

is_last_page_disabled()

Проверка видимости кнопки получения последней страницы с набором данных

Тип результата:

bool

should_be_all_disabled()

Проверка видимости кнопок пагинации: все кнопки disabled

Тип результата:

None

should_be_all_enabled()

Проверка видимости кнопок пагинации: все кнопки enabled

Тип результата:

None

should_be_initial_state()

Проверка видимости кнопок для первой страницы

Тип результата:

None

should_be_final_state()

Проверка видимости кнопок для последней страницы

Тип результата:

None

should_be_events_table()

Проверяет наличие таблицы событий.

Исключение:

AssertionError – Если таблица отсутствует.

Тип результата:

None

should_be_toolbar()

Проверка наличия тулбара

Тип результата:

None

should_be_base_toolbar_buttons()

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

Тип результата:

None

should_be_pagination_buttons()

Проверяет наличие и видимость кнопок пагинации.

Тип результата:

None

components.json_container_component module

Модуль для работы с JSON-контейнерами на веб-страницах.

Содержит компонент для чтения и проверки JSON-данных в контейнерах. Использует playwright для взаимодействия с элементами страницы.

class JsonContainerComponent(page)

Базовые классы: BaseComponent

Компонент для работы с JSON-данными на странице.

Предоставляет методы чтения и проверки JSON-данных в контейнерах.

Параметры:

page (Page)

__init__(page)

Инициализирует JSON-контейнер.

Параметры:

page (Page) – Экземпляр страницы Playwright.

Тип результата:

None

format_json_string(json_string)

Форматирует строку JSON для корректного парсинга.

Параметры:

json_string (str) – Сырая строка с JSON-данными.

Результат:

Отформатированная строка JSON.

Тип результата:

str

read_data(locator)

Читает и форматирует JSON-данные из указанного локатора.

Параметры:

locator (Any) – Локатор элемента с JSON-данными.

Результат:

Распарсенный JSON-объект.

Тип результата:

dict

Исключение:

json.JSONDecodeError – Если данные не могут быть преобразованы в JSON.

check_json_equals(actual, expected, msg)

Сравнивает JSON-объекты на идентичность.

Параметры:

• actual (Any) – Фактический JSON-объект.

• expected (Any) – Ожидаемый JSON-объект.

• msg (str) – Сообщение об ошибке.

Исключение:

AssertionError – Если объекты не идентичны.

Тип результата:

None

components.modal_window_component module

Модуль компонента модального окна. Содержит класс для работы с модальными окнами, их элементами и проверками.

class ModalWindowComponent(page)

Базовые классы: BaseComponent

Компонент модального окна. Предоставляет методы для взаимодействия с окном, его содержимым и проверок.

Параметры:

page (Page)

__init__(page)

Инициализация базового компонента.

Параметры:

page (Page) – экземпляр страницы Playwright.

add_content_item(name, item)

Добавляет элемент содержимого в окно по заданному имени.

Параметры:

• name (str)

• item (object)

Тип результата:

None

get_content_item(name)

Возвращает элемент содержимого по имени или None, если не найден.

Параметры:

name (str)

Тип результата:

object | None

add_toolbar_title(title)

Добавляет заголовок в панель инструментов модального окна.

Параметры:

title (str)

Тип результата:

None

add_toolbar_button(locator, name)

Добавляет кнопку в панель инструментов модального окна.

Параметры:

• locator (str)

• name (str)

Тип результата:

None

add_button(locator, name)

Добавляет кнопку в модальное окно.

Параметры:

• locator (str)

• name (str)

Тип результата:

None

get_button_by_name(name)

Ищет и возвращает кнопку по имени или None, если не найдена.

Параметры:

name (str)

Тип результата:

Button | None

click_button(name)

Кликает по кнопке с заданным именем. Вызывает ошибку, если не найдена.

Параметры:

name (str)

Тип результата:

None

click_toolbar_close_button()

Кликает по кнопке закрытия в панели инструментов.

Тип результата:

None

scroll_window_down()

Прокручивает содержимое окна вниз.

Тип результата:

None

scroll_window_up()

Прокручивает содержимое окна вверх.

Тип результата:

None

scroll_window_left()

Прокручивает содержимое окна влево.

Тип результата:

None

scroll_window_right()

Прокручивает содержимое окна вправо.

Тип результата:

None

check_window_vertical_scrolling()

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

Тип результата:

bool

check_window_horizontal_scrolling()

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

Тип результата:

bool

check_by_window_title()

Проверяет наличие окна по заголовку.

Тип результата:

None

check_button_visibility(name)

Проверяет наличие кнопки по имени. Вызывает ошибку, если не найдена.

Параметры:

name (str)

Тип результата:

None

check_toolbar_button_visibility(name)

Проверяет наличие кнопки в панели инструментов.

Параметры:

name (str)

Тип результата:

None

check_toolbar_button_tooltip(name, tooltip)

Проверяет подсказку у кнопки в панели инструментов.

Параметры:

• name (str)

• tooltip (str)

Тип результата:

None

components.navbar_component module

Модуль компонента панели навигации. Содержит класс для работы с элементами навигации.

class NavigationPanelComponent(page)

Базовые классы: BaseComponent

Компонент панели навигации. Предоставляет методы для взаимодействия с ней.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент панели навигации.

Параметры:

page (Page) – Экземпляр страницы Playwright.

click_item(locator, item_name)

Кликает по элементу с указанным текстом.

Параметры:

• locator (str | Locator) – Локатор элемента или строка с CSS/XPath.

• item_name (str) – Текст элемента для клика.

Тип результата:

None

click_sub_item(node_root_locator, item_name, parent)

Кликает по вложенному элементу с указанным текстом.

Параметры:

• node_root_locator (str | Locator) – Локатор для поиска корневых элементов дерева.

• item_name (str) – Текст элемента для клика.

• parent (None | str)

Тип результата:

None

get_item_names(locator)

Возвращает тексты всех элементов по указанному локатору.

Параметры:

locator (str | Locator) – Локатор элементов или строка с CSS/XPath.

Результат:

Список текстов элементов.

Тип результата:

list[str]

traverse_panel_tree(node_root_locator, level=0, debug=False)

Рекурсивно обходит дерево v-treeview и выводит информацию об элементах.

Параметры:

node_root_locator (str | Locator) – Локатор для поиска корневых элементов дерева.

check_item_visibility(locator, item_name)

Проверяет видимость элемента с указанным текстом.

Параметры:

• locator (str | Locator) – Локатор элемента или строка с CSS/XPath.

• item_name (str) – Текст элемента для проверки.

Тип результата:

None

Примечание

Временная обработка для элементов с текстом „Шаблоны“.

is_item_visible(locator, item_name)

Проверяет видимость элемента с указанным текстом без выбрасывания исключения.

Параметры:

• locator (str | Locator) – Локатор элемента или строка с CSS/XPath.

• item_name (str) – Текст элемента для проверки.

Результат:

True если элемент видим, False если нет.

Тип результата:

bool

components.table_component module

Модуль компонента таблицы. Содержит класс для работы с табличными данными.

class TableComponent(page)

Базовые классы: BaseComponent

Компонент таблицы. Предоставляет методы для работы с табличными данными.

Параметры:

page (Page)

__init__(page)

Инициализирует компонент таблицы.

Параметры:

page (Page) – Экземпляр страницы Playwright.

click_arrow_button(table_locator, index)

Нажатие кнопки-стрелочки вверх/вниз в ячейке заголовка таблицы

Параметры:

• table_locator (str | Locator) – Локатор таблицы.

• index (int) – Индекс ячейки в заголовке.

Тип результата:

None

datetime2timestamp(date_string)

Конвертация строкового представления даты и времени в Unix timestamp :param date_string: Строка с датой и временем в формате d.m.Y H:M:S.

Результат:

Unix timestamp. None: конвертация невозможна

Тип результата:

float

Параметры:

date_string (str)

get_arrow_button_state(table_locator, index)

Получение состояния кнопки-стрелочки вверх/вниз в ячейке заголовка таблицы

Параметры:

• table_locator (str | Locator) – Локатор таблицы.

• index (int) – Индекс ячейки в заголовке.

Результат:

up, если это стрелочка вверх. down, если это стрелочка вниз.

Тип результата:

str

get_header_cell_button(table_locator, index)

Поиск кнопки в ячейке заголовка таблицы

Параметры:

• table_locator (str | Locator) – Локатор таблицы.

• index (int) – Индекс ячейки в заголовке.

Результат:

Локатор строки кнопки.

Исключение:

AssertionError – Если индекс вне диапазона.

Тип результата:

Locator

get_row_locator(table_locator, row_index)

Возвращает локатор строки по индексу.

Параметры:

• table_locator (str | Locator) – Локатор таблицы.

• row_index (int) – Индекс строки.

Результат:

Локатор строки или None, если индекс вне диапазона.

Тип результата:

Locator | None

get_rows_count(locator)

Возвращает количество строк в таблице (без заголовка).

Результат:

Количество строк с данными.

Тип результата:

int

Исключение:

AssertionError – Если таблица пуста.

Параметры:

locator (str | Locator)

read(locator)

Читает данные таблицы, включая заголовки.

Параметры:

locator (str | Locator) – Локатор таблицы.

Результат:

Двумерный список с данными таблицы.

Тип результата:

list[list[str]]

check_table_headers(actual_headers, expected_headers)

Проверка соответствия заголовка таблицы ожидаемому

Тип результата:

None

check_content(locator, expected_headers, check_table_not_empty=True)

Проверяет содержимое таблицы.

Проверяет заголовки и наличие данных в таблице.

Параметры:

• locator (str | Locator) – Локатор таблицы.

• expected_headers (list[str]) – Список ожидаемых заголовков таблицы.

• check_table_not_empty (bool) – Флаг проверки, что таблица не пустая. По умолчанию True.

Исключение:

AssertionError – Если таблица пуста (при check_table_not_empty=True) или заголовки неверны.

Тип результата:

None

check_column_descending_order(locator, index, convert2timestamp=False)

Проверка, что заданный столбец таблицы упорядочен по убыванию.

Параметры:

• locator (str | Locator) – Локатор таблицы.

• index (int) – Индекс столбца.

• convert2timestamp – Конвертировать строковое представление даты и времени в Unix timestamp

Результат:

False

Тип результата:

True, если столбец таблицы упорядочен по убыванию. Иначе

check_first_row_visibility(locator)

Проверяет видимость первой строки таблицы.

Параметры:

locator (str | Locator) – Локатор таблицы.

Тип результата:

None

check_last_row_visibility(locator)

Проверяет видимость последней строки таблицы.

Параметры:

locator (str | Locator) – Локатор таблицы.

Тип результата:

None

check_row_highlighting(locator, row_index)

Проверяет изменение цвета строки при наведении.

Параметры:

• locator (str | Locator) – Локатор таблицы.

• row_index (int) – Индекс проверяемой строки.

Тип результата:

None

components.toolbar_component module

Модуль компонента тулбара (панели инструментов).

Содержит класс ToolbarComponent для работы с элементами тулбара: - Управление кнопками и их подсказками - Проверка видимости элементов - Взаимодействие с панелью инструментов

class ToolbarComponent(page, title)

Базовые классы: BaseComponent

Компонент тулбара. Предоставляет методы для работы с панелью инструментов.

Параметры:

• page (Page) – Экземпляр страницы Playwright

• title (str) – Заголовок тулбара

__init__(page, title)

Инициализирует компонент тулбара с указанным заголовком.

Параметры:

• page (Page)

• title (str)

Тип результата:

None

add_title(title)

Устанавливает новый заголовок тулбара.

Параметры:

title (str) – Новый заголовок

Тип результата:

None

add_tooltip_button(locator, name)

Добавляет кнопку с подсказкой в тулбар.

Параметры:

• locator (Locator) – Локатор кнопки

• name (str) – Уникальное имя кнопки

Тип результата:

None

add_tab_button(locator, name)

Добавляет кнопку типа v-tab в тулбар.

Параметры:

• locator (Locator) – Локатор кнопки

• name (str) – Уникальное имя кнопки

Тип результата:

None

add_button(locator, name)

Добавляет кнопку в тулбар.

Параметры:

• locator (Locator) – Локатор кнопки

• name (str) – Уникальное имя кнопки

Тип результата:

None

get_button_by_name(name)

Возвращает кнопку по имени.

Параметры:

name (str) – Имя кнопки

Результат:

Найденная кнопка или None

Тип результата:

TooltipButton | TabButton | Button | None

click_button(name)

Кликает по кнопке тулбара.

Параметры:

name (str) – Имя кнопки

Исключение:

AssertionError – Если кнопка не найдена

Тип результата:

None

get_toolbar_title_text(locator="//nav//div[contains(@class, 'v-toolbar__title')]", filter_text=None, timeout=5000)

Получает заголовок тулбара окна.

Параметры:

• locator (str) – Локатор для заголовка тулбара

• filter_text (str | None) – Текст для фильтрации заголовка (опционально)

• timeout (int) – Таймаут ожидания в миллисекундах

Результат:

Текст заголовка тулбара

Тип результата:

str

Исключение:

Exception – Если не удалось получить заголовок

is_button_present(name)

Проверяет наличие кнопки.

Параметры:

name (str) – Имя кнопки

Результат:

True если кнопка присутствует

Тип результата:

bool

Исключение:

AssertionError – Если имя кнопки не поддерживается

is_button_not_present(name)

Проверяет отсутствие кнопки.

Параметры:

name (str) – Имя кнопки

Результат:

True если кнопка отсутствует

Тип результата:

bool

Исключение:

AssertionError – Если имя кнопки не поддерживается

check_toolbar_presence(message)

Проверяет видимость тулбара.

Параметры:

message (str) – Сообщение об ошибке если тулбар не виден

Тип результата:

None

check_toolbar_presence_by_locator(locator, message)

Проверяет видимость тулбара.

Параметры:

• locator (str | Locator) – Локатор тулбара

• message (str) – Сообщение об ошибке если тулбар не виден

Тип результата:

None

check_toolbar_presence_by_locator_and_title(locator, message)

Проверяет видимость тулбара.

Параметры:

• locator (str | Locator) – Локатор тулбара

• message (str) – Сообщение об ошибке если тулбар не виден

Тип результата:

None

check_button_visibility(name)

Проверяет наличие и видимость кнопки с предварительной прокруткой.

Параметры:

name (str) – Имя кнопки

Исключение:

AssertionError – Если кнопка не найдена или не видна

Тип результата:

None

check_button_tooltip(name, tooltip)

Проверяет текст подсказки кнопки.

Параметры:

• name (str) – Имя кнопки

• tooltip (str) – Ожидаемый текст подсказки

Исключение:

AssertionError – Если текст подсказки не совпадает

Тип результата:

None

Module contents

Package initialization.