String.length

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La propriétélength représente la longueur d'une chaine de caractères, exprimée en nombre de points de code UTF-16. C'est une propriété accessible en lecture seule.

Exemple interactif

const str = "Life, the universe and everything. Answer:";console.log(`${str} ${str.length}`);// Expected output: "Life, the universe and everything. Answer: 42"

Syntaxe

str.length;

Cette propriété renvoie le nombre de « codets » (ou unités de code ou biencode units en anglais) d'une chaîne de caractèresUTF-16. Le format utilisé pour représenter les chaînes de caractères en JavaScript utilise un seul codet sur 16 bits pour représenter la plupart des caractères communs. En revanche, pour représenter les caractères plus rares, deux codets seront utilisés : la valeur renvoyée parlength ne correspondra alors pas au nombre de caractères dans la chaîne.

ECMAScript 2016 (la septième édition) établit une longueur maximale de2^53 - 1 éléments. Auparavant, aucune longueur maximale n'était spécifiée. Pour Firefox, les chaînes ont une longueur maximale de2^30-2 caractères (environ 1 Go). Pour les versions de Firefox antérieures à Firefox 65, la taille maximale était de de2^28-1 (environ 256 Mo).

Pour une chaine vide, on auralength égal à 0.

La propriété statiqueString.length renvoie la valeur 1.

Exemples

Utiliser`String.length`

const x = "Mozilla";const vide = "";console.log(x + " mesure " + x.length + " codets");/* "Mozilla mesure 7 codets" */console.log("La chaîne vide a une longueur de " + vide.length);/* "La chaîne vide a une longueur de 0" */

Affecter une valeur à`length`

const maChaine = "Sloubi";// Lorsqu'on tente d'affecter une valeur à la propriété length// rien d'observable ne se produitmaChaine.length = 3;console.log(maChaine); /* Sloubi */console.log(maChaine.length); // 6