Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Intl.DisplayNames — nombres localizados para códigos

Intl.DisplayNames convierte códigos de idioma, región y otras categorías en nombres para mostrar según la configuración regional que determine el entorno de ejecución. Aprende qué tipo es obligatorio, cómo se gestionan los nombres que faltan y en qué se diferencian el código de entrada y la configuración regional de salida.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

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

Intl.DisplayNames forma parte de ECMA-402, no de la API DOM. Genera nombres para interfaces de usuario, en lugar de traducir texto arbitrario. En new Intl.DisplayNames("pl", { type: "region" }), "pl" solicita la configuración regional del polaco. El entorno de ejecución busca una coincidencia entre las configuraciones regionales disponibles y puede elegir otra, por lo que no se garantiza un resultado en polaco. El argumento de .of("US") identifica la región cuyo nombre se quiere obtener. El constructor requiere new y la opción type.

type acepta "language", "region", "script", "currency", "calendar" o "dateTimeField". style selecciona la longitud del nombre: "long" (predeterminado), "short" o "narrow"; estas variantes no tienen por qué ser distintas. Para "language", la opción languageDisplay elige "dialect" (predeterminado) o "standard".

.of(code) devuelve un nombre. Si no hay un nombre disponible para un código estructuralmente válido, fallback: "code" (predeterminado) devuelve el código normalizado, mientras que fallback: "none" devuelve undefined. Un código estructuralmente no válido provoca RangeError, independientemente de fallback; "USA" no es un código válido para "region".

resolvedOptions() muestra la configuración efectiva, incluida la configuración regional elegida, en la propiedad locale. Los nombres exactos dependen de los datos de configuración regional del entorno de ejecución, así que no los trates como identificadores estables. Comprueba si Intl.DisplayNames está disponible en el entorno de destino; que exista en Node 24 no demuestra que sea compatible con los navegadores.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes