CKTIS / JavaScript
Intl.ListFormat — formattazione delle liste in base alla lingua
Intl.ListFormat combina gli elementi testuali di una lista usando separatori e congiunzioni appropriati alla lingua. format() restituisce testo, mentre formatToParts() distingue gli elementi originali dal testo di collegamento inserito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new Intl.ListFormat(locales?, options?).format(list)Intl.ListFormat è un'API di internazionalizzazione definita da ECMA-402, non un'API DOM. Crea un formatter con new Intl.ListFormat(locales, options). L'argomento locales seleziona le lingue preferite; se viene omesso, si usa la lingua predefinita dell'ambiente.
L'opzione type accetta "conjunction" (collegamento in stile «e», valore predefinito), "disjunction" (alternative in stile «o») oppure "unit" (un elenco di unità). L'opzione style accetta "long" (valore predefinito), "short" o "narrow". Il formatter non traduce gli elementi e non formatta i numeri o le unità in sé.
format(list) accetta un oggetto iterabile che contiene solo stringhe; un elemento di un altro tipo provoca un TypeError. Una lista vuota produce "". formatToParts(list) restituisce oggetti con i campi type e value: "element" indica un elemento di input e "literal" il testo di collegamento inserito. In questo modo puoi evidenziare gli elementi senza analizzare la punteggiatura.
Il testo di collegamento esatto dipende dai dati linguistici dell'implementazione; non presumere che sia identico in tutti gli ambienti. Verifica la disponibilità di Intl.ListFormat nell'ambiente di destinazione: la sua presenza in Node non dimostra il supporto nei browser. L'esempio verifica la conservazione degli elementi e la ricostruzione del risultato, non un separatore specifico.
Esempi
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));Risultato
["Ada","Lin","Sam"] true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.