feat(confirm_component): добавлены аннотации типов для методов

- Добавлены возвращаемые типы -> None для методов:
  * click_allow_button()
  * click_cancel_button()
  * click_close_button()
  * check_title()
  * check_text()

- Добавлены аннотации параметров:
  * title: str и msg: str в check_title()
  * text: str и msg: str в check_text()

Изменения улучшают ясность кода и помогают в раннем обнаружении ошибок типов.
pull/1/head
Radislav 2025-07-21 15:15:16 +03:00
parent dabca4e3f6
commit de4fc8c7c2
1 changed files with 10 additions and 51 deletions

View File

@ -11,28 +11,9 @@ logger = get_logger("CONFIRM_WINDOW")
class ConfirmComponent(BaseComponent):
"""Компонент окна подтверждения действий.
"""Компонент окна подтверждения действий."""
Предоставляет методы для взаимодействия с диалоговыми окнами подтверждения,
содержащими кнопки отмены и подтверждения действия.
Атрибуты:
page: экземпляр страницы Playwright
title: текстовый элемент заголовка окна
text: текстовый элемент основного сообщения
close_button: кнопка закрытия окна
cancel_button: кнопка отмены действия
allow_button: кнопка подтверждения действия
"""
def __init__(self, page: Page, cancel_button_text: str, allow_button_text: str):
"""Инициализация компонента окна подтверждения.
Args:
page: экземпляр страницы Playwright
cancel_button_text: текст на кнопке отмены
allow_button_text: текст на кнопке подтверждения
"""
super().__init__(page)
self.title = Text(page, ConfirmLocators.TITLE, "confirm title")
@ -51,45 +32,23 @@ class ConfirmComponent(BaseComponent):
)
# Действия:
def click_allow_button(self):
"""Нажатие кнопки подтверждения действия.
Выполняет клик по кнопке с текстом, переданным в allow_button_text.
"""
def click_allow_button(self) -> None:
"""Нажатие кнопки подтверждения действия."""
self.allow_button.click()
def click_cancel_button(self):
"""Нажатие кнопки отмены действия.
Выполняет клик по кнопке с текстом, переданным в cancel_button_text.
"""
def click_cancel_button(self) -> None:
"""Нажатие кнопки отмены действия."""
self.cancel_button.click()
def click_close_button(self):
def click_close_button(self) -> None:
"""Нажатие кнопки закрытия окна подтверждения."""
self.close_button.click()
# Проверки:
def check_title(self, title, msg):
"""Проверка текста заголовка окна подтверждения.
Args:
title: ожидаемый текст заголовка
msg: сообщение об ошибке при несоответствии
Raises:
AssertionError: если текст заголовка не соответствует ожидаемому
"""
def check_title(self, title: str, msg: str) -> None:
"""Проверка текста заголовка окна подтверждения."""
self.title.check_have_text(title, msg)
def check_text(self, text, msg):
"""Проверка текста сообщения в окне подтверждения.
Args:
text: ожидаемый текст сообщения
msg: сообщение об ошибке при несоответствии
Raises:
AssertionError: если текст сообщения не соответствует ожидаемому
"""
def check_text(self, text: str, msg: str) -> None:
"""Проверка текста сообщения в окне подтверждения."""
self.text.check_have_text(text, msg)