Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Intl.Segmenter — segmentation de texte adaptée à la langue

Intl.Segmenter repère les limites des graphèmes, des mots ou des phrases selon des règles adaptées à la langue. Sa méthode segment() renvoie des descriptions de segments itérables, et isWordLike permet de sélectionner ceux qui sont considérés comme des mots.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Intl.Segmenter(locales, { granularity: "word" }).segment(text)

Intl.Segmenter est une API d’internationalisation JavaScript spécifiée dans ECMA-402, déjà présente dans l’édition 2022. Ce n’est pas une API DOM. Son constructeur doit être appelé avec new. L’option granularity accepte "grapheme" (la valeur par défaut), "word" ou "sentence", pour choisir les graphèmes, les mots ou les phrases. Un graphème peut contenir plusieurs points de code : il ne correspond donc pas à une seule unité de code UTF-16.

Intl.Segmenter.prototype.segment(text) renvoie un objet Segments itérable, et non un tableau. Chaque description contient segment — le fragment de texte, index — son indice de départ en unités de code UTF-16, et input — le texte complet fourni en entrée. Utilisez Array.from() si vous avez besoin d’un tableau.

Une description ne possède la propriété booléenne isWordLike qu’avec granularity: "word". Ce n’est pas une méthode du segmentateur. Les espaces et la ponctuation apparaissent aussi dans les résultats ; le filtre part.isWordLike les élimine généralement. La classification et les limites dépendent de l’implémentation et des données linguistiques : ne considérez donc pas cet outil comme un analyseur grammatical universel.

L’exemple sélectionne les mots et affiche leurs indices. Fixer la locale à "en" réduit la dépendance à la langue par défaut, sans garantir une segmentation identique de textes quelconques dans tous les moteurs. Vérifiez la disponibilité dans le navigateur cible : la présence de l’API dans Node 24 ne prouve pas sa prise en charge par les navigateurs. Les sources normatives fournies ne précisent pas les versions de navigateur compatibles.

Exemples

if (typeof Intl === "undefined" || typeof Intl.Segmenter !== "function") {
  throw new Error("Intl.Segmenter is unavailable");
}
const text = "Hello, world!";
const segmenter = new Intl.Segmenter("en", { granularity: "word" });
const words = Array.from(segmenter.segment(text))
  .filter(part => part.isWordLike)
  .map(part => `${part.segment}@${part.index}`);
console.log(words.join(" | "));

Résultat

Hello@0 | world@7

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources