CKTIS / JavaScript
Intl.DisplayNames — локализирани имена за кодове
Intl.DisplayNames преобразува кодове за езици, региони и други категории в имена за показване според локала, избран от средата за изпълнение. Научете кой тип е задължителен, как се обработват липсващите имена и каква е разликата между входния код и локала на резултата.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)Intl.DisplayNames е част от ECMA-402, а не от DOM API. Той създава имена за потребителски интерфейси, вместо да превежда произволен текст. В new Intl.DisplayNames("pl", { type: "region" }) с "pl" се заявява полският локал. Средата за изпълнение търси съвпадение сред наличните локали и може да избере друг, така че резултатът на полски не е гарантиран. Аргументът на .of("US") посочва региона, чието име искаме да получим. Конструкторът изисква new и опцията type.
type приема "language", "region", "script", "currency", "calendar" или "dateTimeField". style задава дължината на името: "long" (по подразбиране), "short" или "narrow"; тези варианти не е задължително да се различават. За "language" опцията languageDisplay избира "dialect" (по подразбиране) или "standard".
.of(code) връща име. Ако няма налично име за структурно валиден код, fallback: "code" (по подразбиране) връща нормализирания код, докато fallback: "none" връща undefined. Структурно невалиден код предизвиква RangeError независимо от fallback; "USA" не е валиден код за "region".
resolvedOptions() показва действително използваните настройки, включително избрания локал в свойството locale. Точните имена зависят от локализационните данни на средата за изпълнение, затова не ги приемайте за стабилни идентификатори. Проверете дали Intl.DisplayNames е наличен в целевата среда; наличието му в Node 24 не доказва поддръжка в браузърите.
Примери
const names = new Intl.DisplayNames("en", { type: "region" });
console.log(typeof names.of("US"));
console.log(names.resolvedOptions().type);
try {
names.of("USA");
} catch (error) {
console.log(error.name);
}Резултат
string region RangeError
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.