Skip to content

TextInput

TextInput

Bases: BaseElement

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

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

Source code in elements\text_input_element.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
class TextInput(BaseElement):
    """Класс для работы с текстовыми полями ввода на странице.

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

    @property
    def type_of(self) -> str:
        """Возвращает тип элемента - 'текстовое поле ввода'.

        Returns:
            Строка с типом элемента.
        """
        return "text input"

    # Действия:
    def get_input_value(self) -> str:
        """Получает текущее значение текстового поля.

        Returns:
            Текущее значение поля ввода.
        """
        logger.info(f'Getting value from text input "{self.name}"')
        return self.locator.input_value()

    def input_value(self, value: str) -> None:
        """Вводит указанное значение в текстовое поле.

        Args:
            value: Значение для ввода.
        """
        logger.info(f'Inputting value "{value}" to text input "{self.name}"')
        self.locator.fill(value)

    def clear(self) -> None:
        """Очищает содержимое текстового поля."""
        logger.info(f'Clearing text input "{self.name}"')
        self.locator.press('Control+A')
        self.locator.press('Backspace')

    # Проверки:
    def check_empty_input(self, msg: str) -> None:
        """Проверяет, что текстовое поле пустое.

        Args:
            msg: Сообщение об ошибке при неудачной проверке.

        Raises:
            AssertionError: Если поле не пустое.
        """
        logger.info(f'Checking that text input "{self.name}" is empty')
        expect(self.locator).to_be_empty(), msg

type_of property

Возвращает тип элемента - 'текстовое поле ввода'.

Returns:

Type Description
str

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

check_empty_input(msg)

Проверяет, что текстовое поле пустое.

Parameters:

Name Type Description Default
msg str

Сообщение об ошибке при неудачной проверке.

 required

Raises:

Type Description
AssertionError

Если поле не пустое.
Source code in elements\text_input_element.py 
49
50
51
52
53
54
55
56
57
58
59
def check_empty_input(self, msg: str) -> None:
    """Проверяет, что текстовое поле пустое.

    Args:
        msg: Сообщение об ошибке при неудачной проверке.

    Raises:
        AssertionError: Если поле не пустое.
    """
    logger.info(f'Checking that text input "{self.name}" is empty')
    expect(self.locator).to_be_empty(), msg

clear()

Очищает содержимое текстового поля.

Source code in elements\text_input_element.py 
42
43
44
45
46
def clear(self) -> None:
    """Очищает содержимое текстового поля."""
    logger.info(f'Clearing text input "{self.name}"')
    self.locator.press('Control+A')
    self.locator.press('Backspace')

get_input_value()

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

Returns:

Type Description
str

Текущее значение поля ввода.
Source code in elements\text_input_element.py 
24
25
26
27
28
29
30
31
def get_input_value(self) -> str:
    """Получает текущее значение текстового поля.

    Returns:
        Текущее значение поля ввода.
    """
    logger.info(f'Getting value from text input "{self.name}"')
    return self.locator.input_value()

input_value(value)

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

Parameters:

Name Type Description Default
value str

Значение для ввода.

 required
Source code in elements\text_input_element.py 
33
34
35
36
37
38
39
40
def input_value(self, value: str) -> None:
    """Вводит указанное значение в текстовое поле.

    Args:
        value: Значение для ввода.
    """
    logger.info(f'Inputting value "{value}" to text input "{self.name}"')
    self.locator.fill(value)