Intl.Collator.prototype.resolvedOptions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

La méthode Intl.Collator.prototype.resolvedOptions() renvoie un nouvel objet dont les propriétés reflètent les options de locale et de collation calculées à l'initialisation de l'objet Collator.

Exemple interactif

Syntaxe

collator.resolvedOptions();

Valeur de retour

Un nouvel objet dont les propriétés reflètent les options de locale et de collations calculées lors de l'initialisation de l'objet Collator.

Description

L'objet renvoyé par cette méthode contient les propriétés suivantes :

locale: La balise de langue BCP 47 qui est réellement utilisée. Si des extensions Unicode étaient fournies avec la balise d'origine et sont supportées pour la locale utilisée, les paires de clés-valeurs seront incluses dans locale.
usage,sensitivity, ignorePunctuation: Les valeurs demandées pour ces propriétés via l'argument options ou celles utilisées par défaut.
collation: La valeur demandée pour l'extension Unicode "co" si elle est supportée par la locale utilisée, sinon "default".
numeric, caseFirst: Les valeurs demandées pour ces propriétés via l'argument options ou l'utilisation des extensions Unicode "kn" et "kf" ou les valeurs par défaut. Si l'implémentation utilisée ne supporte pas ces propriétés, elles sont omises.

Exemples

var de = new Intl.Collator("de", { sensitivity: "base" });
var usedOptions = de.resolvedOptions();

usedOptions.locale; // "de"
usedOptions.usage; // "sort"
usedOptions.sensitivity; // "base"
usedOptions.ignorePunctuation; // false
usedOptions.collation; // "default"
usedOptions.numeric; // false

Spécifications

Specification
ECMAScript® 2025 Internationalization API Specification # sec-intl.collator.prototype.resolvedoptions

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

Intl.Collator