Intl.ListFormat - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Intl.ListFormat

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2021.

L'objet Intl.ListFormat permet le formatage de listes sensible à la langue.

Dans cet article

Exemple interactif

const vehicles = ["Motorcycle", "Bus", "Car"];

const formatter = new Intl.ListFormat("en", {
  style: "long",
  type: "conjunction",
});
console.log(formatter.format(vehicles));
// Résultat attendu : "Motorcycle, Bus, and Car"

const formatter2 = new Intl.ListFormat("de", {
  style: "short",
  type: "disjunction",
});
console.log(formatter2.format(vehicles));
// Résultat attendu : "Motorcycle, Bus oder Car"

const formatter3 = new Intl.ListFormat("en", { style: "narrow", type: "unit" });
console.log(formatter3.format(vehicles));
// Résultat attendu : "Motorcycle Bus Car"

Constructeur

Intl.ListFormat()

Crée un nouvel objet Intl.ListFormat.

Méthodes statiques

Intl.ListFormat.supportedLocalesOf()

Retourne un tableau qui contient les locales, parmi celles fournies en arguments, qui sont prises en charge sans avoir à recourir à la locale par défaut de l'environnement d'exécution.

Propriétés d'instance

Ces propriétés sont définies sur Intl.ListFormat.prototype et partagées par toutes les instances de Intl.ListFormat.

Intl.ListFormat.prototype.constructor

La fonction constructeur qui a créé l'objet d'instance. Pour les instances de Intl.ListFormat, la valeur initiale est le constructeur Intl.ListFormat.

Intl.ListFormat.prototype[Symbol.toStringTag]

La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Intl.ListFormat". Cette propriété est utilisée dans Object.prototype.toString().

Méthodes d'instance

Intl.ListFormat.prototype.format()

Retourne une chaîne de caractères formatée selon la langue, représentant les éléments de la liste.

Intl.ListFormat.prototype.formatToParts()

Retourne un tableau d'objets représentant les différents composants pouvant être utilisés pour formater une liste de valeurs en tenant compte de la locale.

Intl.ListFormat.prototype.resolvedOptions()

Retourne un nouvel objet avec des propriétés reflétant les options de locale et de mise en forme calculées lors de la construction de l'objet Intl.ListFormat courant.

Exemples

Utiliser format()

Dans l'exemple qui suit, on voit comment créer un formateur de liste pour l'anglais.

js
const liste = ["Motorcycle", "Bus", "Car"];

console.log(
  new Intl.ListFormat("en-GB", { style: "long", type: "conjunction" }).format(
    liste,
  ),
);
// Motorcycle, Bus and Car

console.log(
  new Intl.ListFormat("en-GB", { style: "short", type: "disjunction" }).format(
    liste,
  ),
);
// Motorcycle, Bus or Car

console.log(
  new Intl.ListFormat("en-GB", { style: "narrow", type: "unit" }).format(liste),
);
// Motorcycle Bus Car

Utiliser formatToParts()

L'exemple suivant montre comment créer un formateur de liste renvoyant les fragments formatés.

js
const liste = ["Motorcycle", "Bus", "Car"];
console.log(
  new Intl.ListFormat("en-GB", {
    style: "long",
    type: "conjunction",
  }).formatToParts(liste),
);

// [ { "type": "element", "value": "Motorcycle" },
//   { "type": "literal", "value": ", " },
//   { "type": "element", "value": "Bus" },
//   { "type": "literal", "value": ", and " },
//   { "type": "element", "value": "Car" } ];

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 27 févr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Intl.ListFormat
Constructeur
1. Intl.ListFormat()
Méthodes statiques
1. supportedLocalesOf()
Méthodes d'instance
1. format()
2. formatToParts()
3. resolvedOptions()
Héritage
Object/Function
Méthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Propriétés statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Méthodes d'instance
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.DurationFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter