Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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

js
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

js
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