Intl.ListFormat : méthode resolvedOptions()
Baseline
Widely available
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.
La méthode resolvedOptions() des instances de Intl.ListFormat retourne un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet ListFormat.
Exemple interactif
const deListFormatter = new Intl.ListFormat("de-DE", { type: "disjunction" });
const options = deListFormatter.resolvedOptions();
console.log(options.locale);
// Résultat attendu : "de-DE"
console.log(options.style);
// Résultat attendu : "long"
console.log(options.type);
// Résultat attendu : "disjunction"
Syntaxe
resolvedOptions()
Paramètres
Aucun.
Valeur de retour
Un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet ListFormat. L'objet possède les propriétés suivantes, dans l'ordre indiqué :
locale-
La balise BCP 47 language tag réellement utilisée, déterminée par le processus de négociation de la locale. Aucune clé d'extension Unicode ne sera incluse dans le résultat.
type-
La valeur fournie pour cette propriété dans l'argument
options, avec la valeur par défaut si nécessaire. Elle peut valoir"conjunction","disjunction"ou"unit". La valeur par défaut est"conjunction". style-
La valeur fournie pour cette propriété dans l'argument
options, avec la valeur par défaut si nécessaire. Elle peut valoir"long","short"ou"narrow". La valeur par défaut est"long".
Exemples
const deListFormatter = new Intl.ListFormat("de-DE", { style: "short" });
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.style); // "short"
console.log(usedOptions.type); // "conjunction" (la valeur par défaut)
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification> # sec-Intl.ListFormat.prototype.resolvedoptions> |
Compatibilité des navigateurs
Voir aussi
- L'objet
Intl.ListFormat - La méthode
Intl.NumberFormat.prototype.resolvedOptions() - La méthode
Intl.Collator.prototype.resolvedOptions() - La méthode
Intl.DateTimeFormat.prototype.resolvedOptions() - La méthode
Intl.PluralRules.prototype.resolvedOptions()