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

CKTIS / JavaScript

String.length — longueur d’une chaîne en unités UTF-16

La propriété length d’une chaîne renvoie son nombre d’unités de code UTF-16, qui ne correspond pas toujours au nombre de caractères perçus par l’utilisateur. Consultez-la avec text.length, sans parenthèses.

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

text.length

Cette entrée String.length décrit la propriété de longueur d’une valeur chaîne : utilisez text.length, et non text.length(). Le résultat est un entier non négatif qui compte les unités de code UTF-16. Une chaîne vide a une longueur de 0. Il s’agit d’un élément d’ECMAScript, et non d’une API Web.

Ne confondez pas cette valeur avec le nombre de points de code Unicode, de caractères perçus par l’utilisateur ou d’octets. Un emoji représenté par une paire de substituts occupe deux unités. Une lettre suivie d’un signe combinant peut également sembler former un seul caractère malgré une longueur de 2.

La longueur d’une chaîne donnée est immuable ; affecter une valeur à length ne tronque pas le texte. Sur un objet enveloppe String, cette propriété propre n’est ni modifiable, ni énumérable, ni configurable.

Attention à la notation : l’expression littérale String.length lit la longueur de la liste des paramètres du constructeur String, et non celle d’une chaîne. Pour mesurer du texte, placez toujours la valeur chaîne avant .length.

Exemples

const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
  console.log(text.length);
}

Résultat

0
3
2
2

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