Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Валидация JS: Предметно-ориентированное проектирование

const cinemaHall = new CinemaHall(undefined, -5, 0);
cinemaHallRepository.save(cinemaHall);

Обратите внимание на то, что CinemaHall создаётся с неверными параметрами. Что будет, если мы попробуем выполнить такой код? Он выполнится и репозиторий с удовольствием сохранит сущность, которая не должна существовать. Вряд ли такое поведение системы можно назвать удачным. Очевидно, что должен существовать дополнительный механизм, предотвращающий подобные ошибки. Этот механизм существует и называется "валидация".

Валидаций существует много разных типов, и делаться они могут на разных уровнях. Для начала давайте ответим на вопрос: А что необходимо валидировать? Первое правило валидации: никогда не доверяй пользовательским данным. Всё, что приходит из внешних источников, должно проходить валидацию. Даже если ваши пользователи это менеджеры, которые сидят в соседнем кабинете, это не повод им доверять. Хотя бы потому, что они могут ошибиться.

Второй вопрос связан с тем, а какая, собственно, валидация существует. Можно выделить следующие виды:

  • Клиентская валидация
  • Валидация сообщений
  • Валидация на уровне обработчиков
  • Валидация сущностей (Бизнес-Правила)
  • Ограничения на уровне хранилища

В этом уроке мы будем говорить про валидацию сущностей. Ту валидацию, которая отвечает за то, что наше представление предметной области находится в консистентном (согласованном) состоянии.

Yup

Yup — это простая и мощная библиотека для валидации объектов js. Из всего, что было на просторах сети, мне она показалась наиболее удачной, для наших задач.

import * as yup from 'yup';

const schema = yup.object({
  username: yup.string()
    .required()
    .notOneOf(
      ['nicklas'],
      '"${value}" is not allowed',
    ),
  password: yup.string()
    .required()
    .min(6),
});

Для её использования, первым делом необходимо описать схему валидации объекта (schema) с помощью функции yup.object. К каждому свойству привязывается набор ограничений. Каждое ограничение может быть настроено согласно документации. Например, ограничение min конфигурируется минимальным значением длины строки. Кроме того, как правило, в каждое из ограничений опционально можно передать сообщение об ошибке, которое будет выведено в случае если валидация не будет пройдена. Подробнее о том, какие правила встроены в Yup можно прочитать на официальном сайте.

Yup: check

Дальше на сконфигурированной схеме с правилами, можно вызвать синхронный метод validateSync или её асинхронный аналог validate (возвращает промис), в который нужно передать проверяемый объект. На выходе мы получаем либо объект прошедший валидацию, либо будет выброшено исключение (в случае, если были обнаружены ошибки). Для того, что бы процесс валидации не прервался при первом несоответствии, необходимо в метод validateSync передать опциональное свойство abortEarly: false.

schema.validateSync(
  { password: 'bad' },
  { abortEarly: false },
);
// {
//   username: ['username is a required field'],
//   password: ['password must be at least 6 characters']
// }

schema.validateSync(
  { username: 'nick', password: 'better' },
  { abortEarly: false },
);
// { username: 'nick', password: 'better' }

schema.validateSync(
  { username: 'nicklas', password: 'better' },
  { abortEarly: false },
);
// { username: ['"nicklas" is not allowed'] }

schema.validateSync(
  { password: 'better' },
  { abortEarly: false },
);
// { username: ['username is a required field'] }

Теперь попробуем прикрутить эту библиотеку к нашей системе. Вот как это будет выглядеть:

class CinemaService {
  createFilm(name, duration) {
    const film = new Film(name, duration);
    const errors = this.validate(film);
    // { name is a required field" }
    if (!errors) {
      this.FilmRepository.save(film);
    }
    return [film, errors];
  }
}

Здесь есть пара тонкостей, про которые нужно сказать. Во-первых, массив с ошибками нужен, в том числе, снаружи, например для вывода сообщений об ошибках в формах. Во-вторых, мы не можем использовать функцию validateSync напрямую. Связано это с тем, что есть некоторые виды валидаторов, например uniqueness, которые проверяют уникальность сущности, делая обращения к репозиторию. А это значит, что валидатору нужен доступ к объектам репозиториям (ведь объекты мы храним в памяти). То есть в проекте появляется процесс инициализации, в рамках которого мы конфигурируем наш валидатор, передавая репозитории во внутрь.

Обязательно изучите процесс инициализации приложения в практике к этому
уроку

Такой подход к валидации, который подразумевает то, что сущность может быть создана в невалидном состоянии, не единственный способ организации валидации. Более того, в определённых кругах этот подход считается неверным. Я оставлю этот вопрос за рамками урока, но скажу так. На практике, в подавляющем большинстве проектов используются orm, валидация в которых устроена так же, как описано выше. Более того, ограничения, обычно, описываются прямо в самой сущности.

Собирая всё вместе

export default class User {
  static schema = yup.object({
    email: yup.string()
      .email()
      .uniqueness(),
  });

  constructor(email) {
    this.id = uuid();
    this.email = email;
  }
}
import generateValidator from './lib/validation';
const validate = generateValidator(repositories);

const user = new User('test@gmail.com');
const errors = validate(user);

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.

Ошибки, сложный материал, вопросы >
Нашли опечатку или неточность?

Выделите текст, нажмите ctrl + enter и отправьте его нам. В течение нескольких дней мы исправим ошибку или улучшим формулировку.

Что-то не получается или материал кажется сложным?

Загляните в раздел «Обсуждение»:

  • задайте вопрос. Вы быстрее справитесь с трудностями и прокачаете навык постановки правильных вопросов, что пригодится и в учёбе, и в работе программистом;
  • расскажите о своих впечатлениях. Если курс слишком сложный, подробный отзыв поможет нам сделать его лучше;
  • изучите вопросы других учеников и ответы на них. Это база знаний, которой можно и нужно пользоваться.

Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
900
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно.

  • 130 курсов, 2000+ часов теории
  • 900 практических заданий в браузере
  • 360 000 студентов
Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff

Используйте Хекслет по максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»