string

Строка. Пустая строка '' считается незаполненным значением.

Сигнатура

function string(msg?: Message): Schema<string>

Параметры

Параметр	Тип	Описание
msg	Message	Своё сообщение. Заменяет сообщения по умолчанию для всех ошибок этой схемы

Пропускает

Любую непустую строку. Числа не приводятся к строке — для этого есть coerce.string.

Пустыми считаются undefined, null и '' — подробнее в разделе Пустые значения.

Коды ошибок

Код	Когда	Сообщение по умолчанию
required	Значение пустое	Required
string	Не строка	Must be a string

Тексты можно поменять: см. Сообщения и локализация.

Особенности

Строка из пробелов ' ' проходит проверку. Чтобы её запретить: pipe(string(), trim(), minLength(1)).

Чтобы разрешить пустую строку как значение: optional(string(), '').

Примеры

Обязательное поле с правилами

const name = pipe(string('Введите имя'), trim(), minLength(2), maxLength(50));

validate(name, '');      // Введите имя
validate(name, ' Ян ');  // valid, data: 'Ян'

См. также

• pipe — добавить правила
• coerce.string — приведение чисел к строке
• Пустые значения