Примеры использования

Библиотека Validator.js используется для валидации строковых данных на стороне JavaScript и широко применяется при обработке пользовательского ввода в веб-приложениях. Основная идея заключается в предоставлении набора функций, каждая из которых проверяет конкретное свойство строки: формат, длину, состав символов, соответствие шаблонам и другим критериям.

Одним из самых частых сценариев является контроль длины строки. Это критично при обработке имён пользователей, паролей, комментариев и других текстовых полей.

import validator from 'validator';

validator.isLength('username', { min: 3, max: 20 });

Функция isLength позволяет задавать минимальные и максимальные границы. При этом пустые строки и отсутствующие значения требуют отдельной обработки:

validator.isEmpty('');
validator.isEmpty('text'); // false

Проверка символов также часто используется для ограничения допустимого набора:

validator.isAlpha('HelloWorld');
validator.isAlphanumeric('User123');

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

Валидация числовых значений

Validator.js предоставляет набор методов для проверки чисел, представленных строками.

validator.isNumeric('123');
validator.isNumeric('12.3');
validator.isInt('42');

Поддерживается проверка диапазонов:

validator.isInt('10', { min: 5, max: 20 });

При обработке пользовательского ввода важно учитывать, что значения приходят в виде строк, даже если логически представляют числа. Это делает обязательным предварительное приведение типов в бизнес-логике.

Проверка email-адресов

Одним из наиболее используемых методов является проверка корректности email:

validator.isEmail('user@example.com');

Дополнительные параметры позволяют уточнить правила проверки, включая домены и поведение при нестандартных форматах:

validator.isEmail('user@example.com', {
  allow_display_name: true,
  require_tld: true
});

Email-валидация учитывает RFC-спецификации, однако в реальных приложениях часто требуется дополнительная бизнес-логика, связанная с допустимыми доменами или корпоративными правилами.

Проверка URL и сетевых идентификаторов

Для валидации ссылок используется:

validator.isURL('https://example.com');

Метод поддерживает настройку протоколов и требований к формату:

validator.isURL('https://example.com', {
  protocols: ['http', 'https'],
  require_protocol: true
});

Аналогично могут проверяться IP-адреса:

validator.isIP('192.168.0.1');
validator.isIP('2001:db8::1', 6);

Работа с датами и временными значениями

Validator.js включает методы проверки дат в строковом формате:

validator.isDate('2024-01-01');

Также возможно использование строгих форматов:

validator.isISO8601('2024-01-01T10:00:00Z');

Такая проверка применяется при обработке API-запросов, где требуется строгая структура временных меток.

Санитизация данных

Помимо проверки, библиотека предоставляет функции очистки строк.

Экранирование специальных символов:

validator.escape('<script>alert(1)</script>');

Результатом становится безопасная строка, пригодная для отображения в HTML-контексте.

Удаление пробелов:

validator.trim('  text  ');

Нормализация email-адресов:

validator.normalizeEmail('USER@Example.COM');

Нормализация приводит адрес к каноническому виду, что уменьшает вероятность дубликатов в базе данных.

Комбинирование валидаторов

В реальных сценариях используется комбинация нескольких проверок подряд:

const username = 'User123';

const isValid =
  validator.isLength(username, { min: 3, max: 20 }) &&
  validator.isAlphanumeric(username);

Такая композиция позволяет формировать сложные правила без создания дополнительных зависимостей.

Проверка паролей и пользовательских данных

Пароли обычно проверяются на длину и состав:

const password = 'Secret123';

validator.isLength(password, { min: 8 }) &&
validator.matches(password, /[A-Z]/) &&
validator.matches(password, /[0-9]/);

Регулярные выражения часто дополняют возможности Validator.js, так как библиотека не покрывает все сценарии сложности паролей.

Обработка данных API

При работе с серверными API данные приходят в виде строк и требуют строгой проверки перед использованием:

const payload = {
  email: 'user@example.com',
  age: '25'
};

validator.isEmail(payload.email);
validator.isInt(payload.age, { min: 0, max: 120 });

Такой подход снижает вероятность некорректных данных в бизнес-логике приложения.

Ограничения библиотеки

Validator.js работает исключительно со строками, поэтому любые другие типы данных требуют предварительного преобразования. Это накладывает необходимость явного контроля типов на уровне приложения.

Кроме того, библиотека ориентирована на синтаксическую проверку, а не на семантическую. Например, корректный email может не существовать в реальности, но будет считаться валидным.

Практика интеграции в кодовые базы

Validator.js часто используется в middleware серверных приложений и формах фронтенда. Его функции легко комбинируются с логикой Express.js или других фреймворков:

app.post('/register', (req, res) => {
  const { email, password } = req.body;

  if (!validator.isEmail(email)) {
    return res.status(400).send('Invalid email');
  }

  if (!validator.isLength(password, { min: 8 })) {
    return res.status(400).send('Weak password');
  }

  res.send('OK');
});

Подобные конструкции позволяют централизовать проверку входных данных и минимизировать дублирование логики в проекте.

Оглавление