JavaScript Intl.DisplayNames: названия стран и языков
Intl.DisplayNames превращает код страны, языка, валюты или письменности в локализованное название. Вместо таблицы «DE → Германия» браузер берёт данные CLDR и возвращает «Германия», «немецкий» или «доллар США». Это удобно для селектов, профилей и списков без ручного перевода.
Показать страны и языки
const regions = new Intl.DisplayNames(["ru"], {type: "region"});
console.log(regions.of("DE")); // Германия
console.log(regions.of("US")); // Соединенные Штаты
const languages = new Intl.DisplayNames(["ru"], {type: "language"});
console.log(languages.of("en")); // английский
console.log(languages.of("de")); // немецкийПервый аргумент — локаль или список локалей с fallback. type задаёт пространство кодов: region, language, currency, script, calendar, dateTimeField. Для валюты of("USD") вернёт «доллар США», для письменности of("Latn") — «латиница».
Управлять неизвестными кодами
const names = new Intl.DisplayNames(["ru"], {
type: "region",
fallback: "code",
});
console.log(names.of("XX")); // XX
console.log(names.of("DE")); // Германияfallback: "code" возвращает исходный код, если для него нет названия (например, XX); fallback: "none" даёт undefined. По умолчанию используется code. Для зарезервированного ZZ ICU возвращает локализованное «неизвестный регион», а не код — это нормально. Невалидный по формату код (например, Q1) выбрасывает RangeError, поэтому проверяйте входные данные.
DisplayNames не валидирует коды и не заменяет справочник стран: он знает стандартные ISO-коды, но не бизнес-правила. Для валют используйте Intl.NumberFormat с style: "currency", для дат — Intl.DateTimeFormat. Локаль задавайте явно, чтобы серверный и клиентский рендер совпадали.
Метод поддерживается в Chrome 81+, Firefox 86+, Safari 14.1+ и Node.js 14+. Не все локали имеют полные данные; в урезанных ICU-сборках названия могут отсутствовать. Не создавайте форматтер на каждый элемент списка — вынесите его в модуль.
Документация: Intl.DisplayNames, CLDR.