Intl.Segments.prototype.containing()

Baseline 2024
Newly available

Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

La méthode Intl.Segments.containing() renvoie un objet décrivant le segment de la chaîne de caractères contenant le codet situé à l'indice passé en argument.

Exemple interactif

Syntaxe

js
containing(codeUnitIndex);

Paramètres

codeUnitIndex Facultatif

Un nombre correspondant à l'indice du codet dans la chaîne de caractères à segmenter. Si cette valeur est absente, la valeur par défaut sera 0.

Valeur de retour

Un objet qui décrit le segment faisant partie de la chaîne de caractères originale, avec les propriétés suivantes (ou undefined si l'indice fourni est situé en dehors des limites de la chaîne) :

segment

Une chaîne de caractères contenant le segment de la chaîne de caractères originale.

index

L'indice du codet à partir duquel le segment en question commence au sein de la chaîne de caractères originale.

input

La chaîne de caractères originale.

isWordLike

Un booléen présent si granularity vaut "word" ; sinon, undefined. Si granularity vaut "word", isWordLike vaudra true lorsque le segment est semblable à un mot (qu'il contient des lettres/nombres/idéogrammes/etc.) et false sinon.

Exemples

js
// ┃0 1 2 3 4 5┃6┃7┃8┃9  ← Indice des codets
// ┃A l l o n s┃-┃y┃!┃   ← Codets
const input = "Allons-y!";

const segmenter = new Intl.Segmenter("fr", { granularity: "word" });
const segments = segmenter.segment(input);
let current = undefined;

current = segments.containing();
// → { index: 0, segment: "Allons", isWordLike: true }

current = segments.containing(4);
// → { index: 0, segment: "Allons", isWordLike: true }

current = segments.containing(6);
// → { index: 6, segment: "-", isWordLike: false }

current = segments.containing(current.index + current.segment.length);
// → { index: 7, segment: "y", isWordLike: true }

current = segments.containing(current.index + current.segment.length);
// → { index: 8, segment: "!", isWordLike: false }

current = segments.containing(current.index + current.segment.length);
// → undefined

Spécifications

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-%segmentsprototype%.containing

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
containing

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support