Intl.Segmenter : méthode resolvedOptions()
Baseline
2024
Nouvellement disponible
Depuis April 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
La méthode resolvedOptions() des instances de Intl.Segmenter retourne un nouvel objet dont les propriétés reflètent les options calculées lors de l'initialisation de cet objet Segmenter.
Exemple interactif
const segmenter = new Intl.Segmenter("fr-FR");
const options = segmenter.resolvedOptions();
console.log(options.locale);
// Résultat attendu : "fr-FR"
console.log(options.granularity);
// Résultat attendu : "grapheme"
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 Segmenter. L'objet possède les propriétés suivantes, dans l'ordre indiqué :
locale-
La balise de langue BCP 47 pour la locale effectivement utilisée, déterminée par le processus de négociation de la locale. Aucune clé d'extension Unicode ne sera incluse dans la sortie.
granularity-
La valeur fournie pour cette propriété dans l'argument
options, avec les valeurs par défaut remplies si nécessaire. Il s'agit soit de"grapheme","word"ou"sentence". La valeur par défaut est"grapheme".
Exemples
Utilisation simple
const spanishSegmenter = new Intl.Segmenter("es", { granularity: "sentence" });
const options = spanishSegmenter.resolvedOptions();
console.log(options.locale); // "es"
console.log(options.granularity); // "sentence"
Granularité par défaut
const spanishSegmenter = new Intl.Segmenter("es");
const options = spanishSegmenter.resolvedOptions();
console.log(options.locale); // "es"
console.log(options.granularity); // "grapheme"
Locale de recours locale
const banSegmenter = new Intl.Segmenter("ban");
const options = banSegmenter.resolvedOptions();
console.log(options.locale);
// "fr" sur un environnement d'exécution où la locale
// balinaise n'est pas prise en charge et où le
// français est la locale par défaut
console.log(options.granularity); // "grapheme"
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-intl.segmenter.prototype.resolvedoptions |