Обзор

Метод isValidLocale проверяет, корректно ли оформлен код локали и признаётся ли он валидной локалью по стандарту BCP‑47. Он проверяет структуру локали, распознавание языка и корректность региона/писЬменности с использованием API Intl, поддерживает пользовательские соответствия локалей.

Справка

Параметры

Описание параметров

Возвращает

boolean — true, если локаль валидна; иначе — false

Исключения

• Error — если локаль не передана и у экземпляра не настроен targetLocale

Примеры

const gt = new GT({
  sourceLocale: 'en',
  targetLocale: 'es'
});

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false

Примечания

• Выполняет полноценную проверку локалей по BCP‑47 с использованием браузерных API Intl
• Локали с пользовательским сопоставлением всегда считаются валидными (в обход стандартной проверки)
• Поддерживает языковые коды для частного использования (qaa–qtz)
• Возвращает false для некорректных или нераспознаваемых кодов локали

Дальнейшие шаги

• Получить свойства локали с помощью getLocaleProperties
• Определить оптимальную локаль с помощью determineLocale
• Получить названия локалей с помощью getLocaleName
• Подробнее о типе CustomMapping