L'objetIntl.Segmenter permet de segmenter un texte en tenant compte de la locale. On peut ainsi obtenir les éléments utiles (graphèmes, mots ou phrases) d'une chaîne de caractères.

Exemple interactif

const segmenterFr = new Intl.Segmenter("fr", { granularity: "word" });const string1 = "Que ma joie demeure";const iterator1 = segmenterFr.segment(string1)[Symbol.iterator]();console.log(iterator1.next().value.segment);// Expected output: 'Que'console.log(iterator1.next().value.segment);// Expected output: ' '

Constructeur

Intl.Segmenter()

Crée un nouvel objetIntl.Segmenter.

Méthodes statiques

Intl.Segmenter.supportedLocalesOf()

Renvoie un tableau contenant les locales prises en charge, parmi celles fournies en argument, sans avoir à recourir à la locale par défaut de l'environnement par défaut.

Méthodes des instances

Intl.Segmenter.prototype.resolvedOptions()

Renvoie un nouvel objet dont les propriétés reflètent la locale et la granularité calculées lors de l'initialisation de cet objetIntl.Segmenter.

Intl.Segmenter.prototype.segment()

Renvoie une nouvelle instanceSegments itérable qui représente les segments de la chaîne de caractères selon la locale et la granularité portées par cette instanceIntl.Segmenter.

Exemples

Utilisation simple et différence avecString.prototype.split()

En utilisantString.prototype.split(" ") pour segmenter un texte en mots, on n'obtient pas le bon résultat si la locale du texte n'utilise pas d'espace entre les mots (ce qui est le cas pour le japonais, le chinois, le thaïlandais, le laotien, le khmer, le birman, etc.).

const str = "吾輩は猫である。名前はたぬき。";console.table(str.split(" "));// ['吾輩は猫である。名前はたぬき。']// Les deux phrases ne sont pas segmentées correctement.

const str = "吾輩は猫である。名前はたぬき。";const segmenterJa = new Intl.Segmenter("ja-JP", { granularity: "word" });const segments = segmenterJa.segment(str);console.table(Array.from(segments));// [{segment: '吾輩', index: 0, input: '吾輩は猫である。名前はたぬき。', isWordLike: true},// etc.// ]

Spécifications

Compatibilité des navigateurs