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

js
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

js
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 Internationalization API Specification
# sec-intl.collator.prototype.resolvedoptions

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi