PHANTOM
🇮🇳 IN
Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,53 +1,60 @@
---
title: Intl.Collator.prototype.resolvedOptions()
title: "Intl.Collator : méthode resolvedOptions()"
short-title: resolvedOptions()
slug: Web/JavaScript/Reference/Global_Objects/Intl/Collator/resolvedOptions
l10n:
sourceCommit: e7bc0ed5466f5834641d75d416fa81886cf6b37e
---

{{JSRef}}
La méthode **`resolvedOptions()`** des instances de {{JSxRef("Intl.Collator")}} retourne un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet de comparaison.

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 {{jsxref("Collator")}}.

{{InteractiveExample("JavaScript Demo: Intl.Collator.prototype.resolvedOptions")}}
{{InteractiveExample("Démonstration JavaScript : Intl.Collator.prototype.resolvedOptions()")}}

```js interactive-example
const numberDe = new Intl.NumberFormat("de-DE");
const numberAr = new Intl.NumberFormat("ar");

console.log(numberDe.resolvedOptions().numberingSystem);
// Expected output: "latn"
// Résultat attendu : "latn"

console.log(numberAr.resolvedOptions().numberingSystem);
// Expected output: "arab"
// Résultat attendu : "arab"
```

## Syntaxe

```js
collator.resolvedOptions();
```js-nolint
resolvedOptions()
```

### Valeur de retour
### Paramètres

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 {{jsxref("Collator")}}.
Aucun.

## Description
### Valeur de retour

L'objet renvoyé par cette méthode contient les propriétés suivantes :
Un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet `Collator`. L'objet possède les propriétés suivantes, dans l'ordre indiqué :

- `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.
- : {{Glossary("BCP 47 language tag", "L'étiquette de langue BCP 47")}} réellement utilisée, déterminée par le processus de [négociation de la locale](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl#identification_et_négociation_de_locale). Seules les clés d'extension Unicode `co`, `kn` et `kf`, si elles sont demandées et prises en charge, peuvent être incluses dans le résultat.
- `usage`
- : La valeur fournie pour cette propriété dans l'argument `options`, ou la valeur par défaut si nécessaire. Elle vaut soit `"sort"`, soit `"search"`. La valeur par défaut est `"sort"`.
- `sensitivity`
- : La valeur fournie pour cette propriété dans l'argument `options`, ou la valeur par défaut si nécessaire. Elle vaut soit `"base"`, `"accent"`, `"case"` ou `"variant"`. La valeur par défaut est `"variant"` pour l'usage `"sort"` ; elle dépend de la locale pour l'usage `"search"`.
- `ignorePunctuation`
- : La valeur fournie pour cette propriété dans l'argument `options`, ou la valeur par défaut si nécessaire. Il s'agit d'un booléen. La valeur par défaut est `true` pour le thaï (`th`) et `false` pour toutes les autres langues.
- `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.
- : La valeur fournie pour cette propriété dans l'argument `options`, ou via la clé d'extension Unicode `"co"`, ou la valeur par défaut si nécessaire. Il s'agit d'un [type de collation](/fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/supportedValuesOf#types_de_collation_pris_en_charge) pris en charge pour cette locale. La valeur par défaut est `"default"`.
- `numeric`
- : La valeur fournie pour cette propriété dans l'argument `options`, ou via la clé d'extension Unicode `"kn"`, ou la valeur par défaut si nécessaire. Il s'agit d'un booléen. La valeur par défaut est `false`. Si l'implémentation ne prend pas en charge cette clé d'extension Unicode, cette propriété est omise.
- `caseFirst`
- : La valeur fournie pour cette propriété dans l'argument `options`, ou via la clé d'extension Unicode `"kf"`, ou la valeur par défaut si nécessaire. Elle vaut soit `"upper"`, `"lower"` ou `"false"`. La valeur par défaut est `"false"`. Si l'implémentation ne prend pas en charge cette clé d'extension Unicode, cette propriété est omise.

## Exemples

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

usedOptions.locale; // "de"
usedOptions.usage; // "sort"
Expand All @@ -67,4 +74,4 @@ usedOptions.numeric; // false

## Voir aussi

- {{jsxref("Collator", "Intl.Collator")}}
- L'objet {{JSxRef("Intl.Collator")}}