# 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.