Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Intl.DisplayNames — nomes localizados para códigos

Intl.DisplayNames converte códigos de idioma, região e outras categorias em nomes a apresentar de acordo com a configuração regional escolhida pelo ambiente de execução. Saiba qual é o tipo obrigatório, como são tratados os nomes em falta e qual a diferença entre o código de entrada e a configuração regional de saída.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Intl.DisplayNames(locales, { type, style, fallback, languageDisplay }).of(code)

Intl.DisplayNames faz parte de ECMA-402, não da API DOM. Produz nomes para interfaces de utilizador, em vez de traduzir texto arbitrário. Em new Intl.DisplayNames("pl", { type: "region" }), "pl" indica que se pretende a configuração regional do polaco. O ambiente de execução procura uma correspondência entre as configurações regionais disponíveis e pode escolher outra, pelo que não há garantia de que o resultado esteja em polaco. O argumento de .of("US") identifica a região cujo nome se pretende obter. O construtor requer new e a opção type.

type aceita "language", "region", "script", "currency", "calendar" ou "dateTimeField". style seleciona o comprimento do nome: "long" (predefinido), "short" ou "narrow"; estas variantes não têm necessariamente de ser diferentes. Para "language", a opção languageDisplay escolhe "dialect" (predefinido) ou "standard".

.of(code) devolve um nome. Se não estiver disponível um nome para um código estruturalmente válido, fallback: "code" (predefinido) devolve o código normalizado, enquanto fallback: "none" devolve undefined. Um código estruturalmente inválido gera RangeError, independentemente de fallback; "USA" não é um código válido para "region".

resolvedOptions() apresenta as definições efetivas, incluindo a configuração regional escolhida na propriedade locale. Os nomes exatos dependem dos dados de localização do ambiente de execução, por isso não os considere identificadores estáveis. Verifique se Intl.DisplayNames está disponível no ambiente de destino; a sua presença no Node 24 não comprova o suporte nos browsers.

Exemplos

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);
}

Resultado

string
region
RangeError

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes