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

CKTIS / JavaScript

Intl.ListFormat — formato de listas según la configuración regional

Intl.ListFormat combina elementos de texto de una lista mediante separadores y conjunciones adecuados para la configuración regional. format() devuelve texto, mientras que formatToParts() separa los elementos originales del texto de conexión añadido.

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.ListFormat(locales?, options?).format(list)

Intl.ListFormat es una API de internacionalización definida por ECMA-402, no una API del DOM. Crea un formateador con new Intl.ListFormat(locales, options). El argumento locales selecciona las configuraciones regionales preferidas; si se omite, se usa la configuración regional predeterminada del entorno.

La opción type acepta "conjunction" (unión de tipo «y», valor predeterminado), "disjunction" (alternativas de tipo «o») o "unit" (una lista de unidades). La opción style acepta "long" (valor predeterminado), "short" o "narrow". El formateador no traduce los elementos ni da formato a los números o las unidades en sí.

format(list) acepta un objeto iterable que contenga únicamente cadenas; un elemento de otro tipo provoca un TypeError. Una lista vacía produce "". formatToParts(list) devuelve objetos con los campos type y value: "element" identifica un elemento de entrada y "literal" identifica el texto de conexión añadido. Así puedes resaltar los elementos sin analizar la puntuación.

El texto de conexión exacto depende de los datos regionales de la implementación; no des por sentado que será idéntico en todos los entornos. Comprueba si Intl.ListFormat está disponible en el entorno de destino: que exista en Node no demuestra que sea compatible con los navegadores. El ejemplo comprueba que se conservan los elementos y que se reconstruye el resultado, no un separador concreto.

Ejemplos

const formatter = new Intl.ListFormat("en", {
  type: "conjunction",
  style: "long"
});
const items = ["Ada", "Lin", "Sam"];
const parts = formatter.formatToParts(items);
console.log(JSON.stringify(parts.filter(p => p.type === "element").map(p => p.value)));
console.log(parts.map(p => p.value).join("") === formatter.format(items));

Resultado

["Ada","Lin","Sam"]
true

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