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