Модуль validator.js представляет собой набор функций для проверки и валидации строковых данных, ориентированных на типовые задачи веб-разработки: формы, API-входные данные, пользовательский ввод, внешние интеграции. Все проверки выполняются над строками, поэтому любые значения предварительно приводятся к строковому виду.
Проверяет, является ли строка пустой. Пустыми считаются строки нулевой длины, а также строки, содержащие только пробелы (в зависимости от параметров).
Типичные сценарии:
Особенность: позволяет учитывать или игнорировать пробелы.
Проверяет длину строки в заданных границах.
Параметры:
min — минимальная длинаmax — максимальная длинаИспользуется для:
Проверяет наличие подстроки внутри строки.
Дополнительно поддерживает опции:
Применяется при:
Сравнивает две строки на полное совпадение.
Используется в:
Проверяет, состоит ли строка только из числовых символов.
Особенности:
Проверяет, является ли строка целым числом.
Поддерживает параметры:
Применяется для:
Проверяет число с плавающей точкой.
Используется при:
Более строгая проверка десятичных чисел с контролем формата.
Проверяет строку на соответствие денежному формату.
Поддерживает:
Проверяет, состоит ли строка только из букв.
Опции позволяют учитывать:
Используется для:
Проверяет комбинацию букв и цифр без специальных символов.
Применяется для:
Проверяет, содержит ли строка только ASCII-символы.
Проверка регистра символов.
Используется для:
Проверяет строку на соответствие UUID формату.
Поддерживаются версии:
Применяется в:
Проверяет, является ли строка валидным JSON.
Особенности:
Проверяет структуру JSON Web Token.
Используется в:
Проверяет строку на соответствие криптографическому хэшу.
Поддерживает алгоритмы:
Проверяет Base64-формат строки.
Применение:
Проверяет корректность URL-адреса.
Поддерживает:
Проверяет корректность email-адреса.
Учитывает:
Проверяет IP-адрес.
Поддержка:
Проверяет MAC-адрес устройства.
Проверяет полностью квалифицированное доменное имя.
Проверяет номер сетевого порта.
Диапазон:
Проверяет Data URI схему.
Проверяет корректность даты.
Поддерживает различные форматы, включая ISO и локальные представления.
Проверяет дату в стандарте ISO 8601.
Проверяет, что дата позже указанной границы.
Проверяет, что дата раньше указанной границы.
Проверяет координаты широты и долготы.
Формат:
lat, longПроверяет почтовый индекс.
Поддерживает различные страны через локали.
Проверяет номер мобильного телефона.
Особенности:
Проверяет MIME-тип.
Примеры:
image/pngapplication/jsonПроверяет magnet-ссылки (P2P).
Проверяет адреса Ethereum.
Проверяет Bitcoin-адреса.
Проверяет номера удостоверений личности (в зависимости от страны).
Проверяет налоговые идентификаторы (локалезависимо).
Проверяет, входит ли значение в список допустимых значений.
Применение:
Проверка строки по регулярному выражению.
Используется для:
Позволяет реализовать любые нестандартные проверки.
Проверяет булевы значения, представленные строкой.
Поддерживает:
true/false1/0yes/no (в зависимости от настроек)При расширенной настройке учитывает:
Повторная категория валидации типов контента используется при обработке файлов и HTTP-заголовков.
Проверяет дату по стандарту RFC 3339, часто используемому в API.
Функции библиотеки образуют несколько крупных групп:
Каждая функция ориентирована на узкую задачу и используется как независимый строительный блок для формирования сложной логики проверки входных данных в приложениях различного уровня.