Почтовые индексы разных стран

Модуль проверки почтовых индексов в Validator.js реализован через функцию isPostalCode, ориентированную на учёт национальных форматов разных стран. Почтовые индексы не являются универсальными: в одних странах используется только числовая форма фиксированной длины, в других — буквенно-цифровые комбинации, иногда с пробелами или дефисами.

Библиотека решает задачу унификации проверки за счёт набора локалей, каждая из которых соответствует конкретному формату.

Общий принцип работы isPostalCode

Функция проверки имеет следующий базовый синтаксис:

validator.isPostalCode(input, locale)
  • input — строка, содержащая предполагаемый почтовый индекс
  • locale — строка, определяющая страну или тип формата

Возвращаемое значение:

  • true — если значение соответствует формату
  • false — если не соответствует

Валидация происходит через регулярные выражения, адаптированные под конкретные национальные стандарты.

Поддерживаемые локали и их особенности

Validator.js поддерживает широкий набор стран. Каждая локаль отражает уникальную структуру почтового кода.

Общие и универсальные режимы

any

Режим any допускает широкий спектр форматов. Используется, когда страна неизвестна или требуется мягкая проверка.

validator.isPostalCode('12345', 'any'); // true
validator.isPostalCode('SW1A 1AA', 'any'); // true

Этот режим полезен для предварительной валидации, но не гарантирует соответствие конкретной стране.

Европа

Великобритания (GB)

Формат включает буквы, цифры и пробел:

  • Пример: SW1A 1AA
validator.isPostalCode('SW1A 1AA', 'GB'); // true

Особенность: строгая структура районов и секторов.

Германия (DE)

Только числовой формат из 5 цифр:

  • Пример: 10115
validator.isPostalCode('10115', 'DE'); // true

Франция (FR)

Пять цифр, первые две часто обозначают департамент:

  • Пример: 75001
validator.isPostalCode('75001', 'FR'); // true

Италия (IT)

Пять цифр:

  • Пример: 00100
validator.isPostalCode('00100', 'IT'); // true

Испания (ES)

Пять цифр, первая — регион:

  • Пример: 28013
validator.isPostalCode('28013', 'ES'); // true

Нидерланды (NL)

Комбинация из четырёх цифр и двух букв:

  • Пример: 1234 AB
validator.isPostalCode('1234 AB', 'NL'); // true

Швейцария (CH)

Четыре цифры:

  • Пример: 8001
validator.isPostalCode('8001', 'CH'); // true

Северная Америка

США (US)

Пять цифр или ZIP+4:

  • 12345
  • 12345-6789
validator.isPostalCode('90210', 'US'); // true
validator.isPostalCode('90210-1234', 'US'); // true

Канада (CA)

Чередование буква-цифра-буква:

  • Пример: K1A 0B1
validator.isPostalCode('K1A 0B1', 'CA'); // true

Азия

Япония (JP)

Семь цифр с дефисом:

  • Пример: 123-4567
validator.isPostalCode('123-4567', 'JP'); // true

Индия (IN)

Шесть цифр:

  • Пример: 110001
validator.isPostalCode('110001', 'IN'); // true

Китай (CN) (в некоторых версиях как общий формат)

Шесть цифр:

  • Пример: 100000
validator.isPostalCode('100000', 'CN'); // true

Ближний Восток и другие регионы

Израиль (IL)

Семь цифр:

  • Пример: 6150001
validator.isPostalCode('6150001', 'IL'); // true

Саудовская Аравия (SA)

Пять цифр:

  • Пример: 11564
validator.isPostalCode('11564', 'SA'); // true

Южная Америка

Бразилия (BR)

Восемь цифр с дефисом:

  • Пример: 12345-678
validator.isPostalCode('12345-678', 'BR'); // true

Африка

ЮАР (ZA)

Четыре цифры:

  • Пример: 8001
validator.isPostalCode('8001', 'ZA'); // true

Австралия и Океания

Австралия (AU)

Четыре цифры:

  • Пример: 2000
validator.isPostalCode('2000', 'AU'); // true

Новая Зеландия (NZ)

Четыре цифры:

  • Пример: 6011
validator.isPostalCode('6011', 'NZ'); // true

Логика выбора локали

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

Пример типичной проблемы:

validator.isPostalCode('10115', 'US'); // false
validator.isPostalCode('10115', 'DE'); // true

Одно и то же значение интерпретируется по-разному в зависимости от страны.

Смешанные форматы и ограничения

Некоторые почтовые индексы включают:

  • пробелы (GB, CA, NL)
  • дефисы (JP, BR, US)
  • буквенные префиксы (CA, NL)
  • переменную длину (GB)

Validator.js не нормализует строки автоматически. Перед проверкой обычно требуется:

  • удаление лишних пробелов
  • приведение к верхнему регистру (для буквенных систем)
  • проверка отсутствия недопустимых символов

Частые ошибки при использовании

Игнорирование регистра

validator.isPostalCode('k1a 0b1', 'CA'); // может вернуть false

Неправильная локаль

validator.isPostalCode('75001', 'US'); // false

Передача числового значения вместо строки

validator.isPostalCode(75001, 'FR'); // некорректное использование

Работа с динамическими формами

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

  • определение страны
  • выбор локали
  • проверка isPostalCode

Пример логики:

function validatePostalCode(code, country) {
  return validator.isPostalCode(code, country);
}

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

  • выбор страны в форме
  • IP-геолокацию
  • профиль пользователя

Поведение при неизвестных форматах

Если передана неподдерживаемая локаль, функция возвращает false. Это требует явной обработки:

  • валидация списка допустимых стран до вызова
  • fallback на any при отсутствии данных
validator.isPostalCode('12345', 'XX'); // false

Практическая специфика использования

Validator.js не предназначен для интерпретации географического смысла кода. Проверяется исключительно синтаксис.

Это означает:

  • корректный формат не гарантирует существование почтового индекса
  • проверка не обращается к внешним базам данных
  • результат основан только на регулярных выражениях

Типовые сценарии применения

  • регистрация пользователей с адресами
  • оформление заказов в e-commerce
  • заполнение профилей доставки
  • интеграция CRM-систем
  • международные формы ввода данных

Особенности расширяемости

При необходимости поддерживать нестандартные форматы обычно используются:

  • предварительная нормализация строки
  • кастомные регулярные выражения до вызова isPostalCode
  • комбинированная проверка (страна + формат + длина)

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

Оглавление