Встроенные валидаторы

Все встроенные валидаторы — фабрики из @reformer/core/validators. Каждая возвращает Validator<TForm, TField> и кладётся в массив validators узла схемы: validators: [required(), email()].

Общие правила:

Пустые значения пропускаются. '', null, undefined (а для длины/чисел/дат — и невалидные значения) считаются валидными. Обязательность проверяет отдельная фабрика required().
Опция { message }. Любой фабрике можно передать свой текст: min(18, { message: 'Только 18+' }). Без него message резолвится из code в слое отображения.
Omnibus number() удалён. Числовые проверки собираются из отдельных фабрик (isNumber(), integer(), min(), …).

Общие

`required(options?)`

Поле должно быть заполнено. Пустыми считаются null, undefined, '', [] (пустой массив), а для boolean — любое значение, кроме true (обязательный чекбокс).

import { required } from '@reformer/core/validators';

email: { value: model.$.email, component: Input, validators: [required()] },
agreeToTerms: {
  value: model.$.agreeToTerms,
  component: Checkbox,
  validators: [required({ message: 'Необходимо принять условия' })],
},
// Ошибка: { code: 'required', message }

`pattern(regex, options?)`

Значение должно соответствовать регулярному выражению.

import { pattern } from '@reformer/core/validators';

code: {
  value: model.$.code,
  component: Input,
  validators: [pattern(/^[A-Z]+$/, { message: 'Только заглавные латинские буквы' })],
},
// Ошибка: { code: 'pattern', params: { pattern: '^[A-Z]+$' } }

`email(options?)`

Формат email (упрощённый regex ^[^\s@]+@[^\s@]+\.[^\s@]+$).

import { required, email } from '@reformer/core/validators';

email: { value: model.$.email, component: Input, validators: [required(), email()] },
// Ошибка: { code: 'email' }

`url(options?)`

Формат URL. Дополнительные опции: requireProtocol (требовать http(s)://) и allowedProtocols (ограничить набор протоколов).

import { url } from '@reformer/core/validators';

website: { value: model.$.website, component: Input, validators: [url()] },
homepage: {
  value: model.$.homepage,
  component: Input,
  validators: [url({ requireProtocol: true, allowedProtocols: ['https'] })],
},
// Ошибки: { code: 'url' } либо { code: 'url_protocol', params: { allowedProtocols } }

`phone(options?)`

Номер телефона. Формат задаётся опцией format типа PhoneFormat:

type PhoneFormat = 'international' | 'ru' | 'us' | 'any'; // по умолчанию 'any'

import { required, phone } from '@reformer/core/validators';

phone: {
  value: model.$.phone,
  component: Input,
  validators: [required(), phone({ format: 'ru' })],
},
// Ошибка: { code: 'phone', params: { format: 'ru' } }

Длина строки

Работают со строкой или массивом (проверяется value.length).

`minLength(n, options?)` · `maxLength(n, options?)`

import { minLength, maxLength } from '@reformer/core/validators';

name: { value: model.$.name, component: Input, validators: [minLength(2)] },
bio: { value: model.$.bio, component: Textarea, validators: [maxLength(500)] },
// minLength → { code: 'minLength', params: { minLength: 2, actualLength: 1 } }
// maxLength → { code: 'maxLength', params: { maxLength: 500, actualLength: 501 } }

Непустой массив

Требование «хотя бы один элемент» — это minLength(1) на поле-массиве: validators: [minLength(1, { message: 'Добавьте хотя бы один элемент' })].

Числа

Все числовые фабрики пропускают null/undefined; кроме isNumber, они также пропускают не-числа и NaN — строгую проверку типа даёт isNumber().

`min(n, options?)` · `max(n, options?)`

Границы значения (включительно).

import { min, max } from '@reformer/core/validators';

age: { value: model.$.age, component: Input, validators: [min(18)] },
discount: { value: model.$.discount, component: Input, validators: [max(50)] },
// min → { code: 'min', params: { min: 18, actual: 16 } }
// max → { code: 'max', params: { max: 50, actual: 75 } }

`isNumber(options?)`

Значение — конечное число (не строка, не NaN).

import { required, isNumber } from '@reformer/core/validators';

amount: { value: model.$.amount, component: Input, validators: [required(), isNumber()] },
// Ошибка: { code: 'isNumber' }

`integer(options?)`

Число должно быть целым.

import { integer } from '@reformer/core/validators';

count: { value: model.$.count, component: Input, validators: [integer()] },
// Ошибка: { code: 'integer' }

`multipleOf(n, options?)`

Число кратно делителю (сравнение с допуском — безопасно для дробного шага).

import { multipleOf } from '@reformer/core/validators';

rating: { value: model.$.rating, component: Input, validators: [multipleOf(0.5)] },
// Ошибка: { code: 'multipleOf', params: { multipleOf: 0.5 } }

`nonNegative(options?)` · `nonZero(options?)`

nonNegative — число ≥ 0; nonZero — число не равно нулю.

import { nonNegative, nonZero } from '@reformer/core/validators';

balance: { value: model.$.balance, component: Input, validators: [nonNegative()] },
divisor: { value: model.$.divisor, component: Input, validators: [nonZero()] },
// nonNegative → { code: 'nonNegative' }
// nonZero     → { code: 'nonZero' }

Собирайте числовые проверки из фабрик

Единой фабрики number() больше нет. Составьте нужный набор:

import { isNumber, integer, min, max } from '@reformer/core/validators';

percent: {
  value: model.$.percent,
  component: Input,
  validators: [isNumber(), integer(), min(0), max(100)],
},

Даты

Принимают Date или строку, парсимую в дату. Сравнение — по нормализованным датам (время обнуляется). Пустые и невалидные даты пропускаются (используйте required() и isDate()).

`isDate(options?)`

Значение — валидная дата.

import { required, isDate } from '@reformer/core/validators';

eventDate: { value: model.$.eventDate, component: DatePicker, validators: [required(), isDate()] },
// Ошибка: { code: 'date_invalid' }

`minDate(date, options?)` · `maxDate(date, options?)`

Границы даты (включительно).

import { minDate, maxDate } from '@reformer/core/validators';

startDate: { value: model.$.startDate, component: DatePicker, validators: [minDate(new Date())] },
birthDate: { value: model.$.birthDate, component: DatePicker, validators: [maxDate(new Date())] },
// minDate → { code: 'date_min', params: { minDate } }
// maxDate → { code: 'date_max', params: { maxDate } }

`pastDate(options?)` · `futureDate(options?)`

pastDate — дата не в будущем; futureDate — дата не в прошлом (относительно сегодняшнего дня).

import { pastDate, futureDate } from '@reformer/core/validators';

birthDate: { value: model.$.birthDate, component: DatePicker, validators: [pastDate()] },
appointment: { value: model.$.appointment, component: DatePicker, validators: [futureDate()] },
// pastDate   → { code: 'date_future' } (дата оказалась в будущем)
// futureDate → { code: 'date_past' }   (дата оказалась в прошлом)

`minAge(years, options?)` · `maxAge(years, options?)`

Возраст по дате рождения (в полных годах).

import { required, minAge, maxAge } from '@reformer/core/validators';

birthDate: {
  value: model.$.birthDate,
  component: DatePicker,
  validators: [required(), minAge(18), maxAge(100)],
},
// minAge → { code: 'date_min_age', params: { minAge: 18, currentAge } }
// maxAge → { code: 'date_max_age', params: { maxAge: 100, currentAge } }

Комбинирование

К одному полю можно применить несколько валидаторов — выполняются все, ошибки собираются в массив:

import { required, minLength, pattern } from '@reformer/core/validators';

password: {
  value: model.$.password,
  component: Input,
  validators: [
    required(),
    minLength(8),
    pattern(/[A-Z]/, { message: 'Нужна заглавная буква' }),
    pattern(/[0-9]/, { message: 'Нужна цифра' }),
  ],
},

Справочник

Категория	Фабрика	Код ошибки	`params`
Общие	`required()`	`required`	—
Общие	`pattern(regex)`	`pattern`	`{ pattern }`
Общие	`email()`	`email`	—
Общие	`url()`	`url` / `url_protocol`	`{ allowedProtocols }`
Общие	`phone()`	`phone`	`{ format }`
Длина	`minLength(n)`	`minLength`	`{ minLength, actualLength }`
Длина	`maxLength(n)`	`maxLength`	`{ maxLength, actualLength }`
Числа	`min(n)`	`min`	`{ min, actual }`
Числа	`max(n)`	`max`	`{ max, actual }`
Числа	`isNumber()`	`isNumber`	—
Числа	`integer()`	`integer`	—
Числа	`multipleOf(n)`	`multipleOf`	`{ multipleOf }`
Числа	`nonNegative()`	`nonNegative`	—
Числа	`nonZero()`	`nonZero`	—
Даты	`isDate()`	`date_invalid`	—
Даты	`minDate(d)`	`date_min`	`{ minDate }`
Даты	`maxDate(d)`	`date_max`	`{ maxDate }`
Даты	`pastDate()`	`date_future`	—
Даты	`futureDate()`	`date_past`	—
Даты	`minAge(n)`	`date_min_age`	`{ minAge, currentAge }`
Даты	`maxAge(n)`	`date_max_age`	`{ maxAge, currentAge }`

Дальше

Кастомные валидаторы — свои правила и кросс-полевые проверки.
Асинхронная валидация — проверки через сервер.
Обработка ошибок — чтение и отображение ошибок.

Общие​

required(options?)​

pattern(regex, options?)​

email(options?)​

url(options?)​

phone(options?)​

Длина строки​

minLength(n, options?) · maxLength(n, options?)​

Числа​

min(n, options?) · max(n, options?)​

isNumber(options?)​

integer(options?)​

multipleOf(n, options?)​

nonNegative(options?) · nonZero(options?)​

Даты​

isDate(options?)​

minDate(date, options?) · maxDate(date, options?)​

pastDate(options?) · futureDate(options?)​

minAge(years, options?) · maxAge(years, options?)​

Комбинирование​

Справочник​

Дальше​