Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.ListFormat — formater des listes selon la locale

Intl.ListFormat relie les éléments textuels d’une liste à l’aide de séparateurs et de conjonctions adaptés à la locale. format() renvoie du texte, tandis que formatToParts() distingue les éléments d’origine du texte de liaison ajouté.

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

Syntaxe

new Intl.ListFormat(locales?, options?).format(list)

Intl.ListFormat est une API d’internationalisation définie par ECMA-402, et non une API DOM. Créez un formateur avec new Intl.ListFormat(locales, options). L’argument locales sélectionne les locales préférées ; s’il est omis, la locale par défaut de l’environnement est utilisée.

L’option type accepte "conjunction" (liaison de type « et », valeur par défaut), "disjunction" (alternatives de type « ou ») ou "unit" (une liste d’unités). L’option style accepte "long" (valeur par défaut), "short" ou "narrow". Le formateur ne traduit pas les éléments et ne formate pas les nombres ou les unités eux-mêmes.

format(list) accepte un objet itérable contenant uniquement des chaînes ; un élément d’un autre type provoque une TypeError. Une liste vide produit "". formatToParts(list) renvoie des objets dotés des champs type et value : "element" désigne un élément d’entrée et "literal" le texte de liaison ajouté. Vous pouvez ainsi mettre en évidence les éléments sans analyser la ponctuation.

Le texte de liaison exact dépend des données de locale de l’implémentation ; ne supposez pas qu’il sera identique dans tous les environnements. Vérifiez la disponibilité de Intl.ListFormat dans l’environnement cible : sa présence dans Node ne prouve pas la prise en charge par les navigateurs. L’exemple vérifie la préservation des éléments et la reconstruction du résultat, pas un séparateur particulier.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources