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

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

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

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

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

Валидация

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);

<span class="translation_missing" title="translation missing: ru.web.courses.lessons.mentors.mentor_avatars">Mentor Avatars</span>

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

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

Для полного доступа к курсу нужна профессиональная подписка

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

Получить доступ
115
курсов
892
упражнения
2241
час теории
3196
тестов

Зарегистрироваться

или войти в аккаунт

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

  • 115 курсов, 2000+ часов теории
  • 800 практических заданий в браузере
  • 250 000 студентов

Нажимая кнопку «Зарегистрироваться», вы даёте своё согласие на обработку персональных данных в соответствии с «Политикой конфиденциальности» и соглашаетесь с «Условиями оказания услуг». Защита от спама reCAPTCHA «Конфиденциальность» и «Условия использования».

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

Логотип компании Альфа Банк
Логотип компании Rambler
Логотип компании Bookmate
Логотип компании Botmother

Есть вопрос или хотите участвовать в обсуждении?

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

Нажимая кнопку «Зарегистрироваться», вы даёте своё согласие на обработку персональных данных в соответствии с «Политикой конфиденциальности» и соглашаетесь с «Условиями оказания услуг». Защита от спама reCAPTCHA «Конфиденциальность» и «Условия использования».