[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/length [Back]  [Original]

String.length - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.length

Baseline Large disponibilit

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 proprit length reprsente la longueur d'une chaine de caractres, exprime en nombre de points de code UTF-16. C'est une proprit accessible en lecture seule.

Dans cet article

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

js
str.length;

Description

Cette proprit renvoie le nombre de codets (ou units de code ou bien code units en anglais) d'une chane de caractres UTF-16. Le format utilis pour reprsenter les chanes de caractres en JavaScript utilise un seul codet sur 16 bits pour reprsenter la plupart des caractres communs. En revanche, pour reprsenter les caractres plus rares, deux codets seront utiliss : la valeur renvoye par length ne correspondra alors pas au nombre de caractres dans la chane.

ECMAScript 2016 (la septime dition) tablit une longueur maximale de 2^53 - 1 lments. Auparavant, aucune longueur maximale n'tait spcifie. Pour Firefox, les chanes ont une longueur maximale de 2^30-2 caractres (environ 1 Go). Pour les versions de Firefox antrieures Firefox 65, la taille maximale tait de de 2^28-1 (environ 256 Mo).

Pour une chaine vide, on aura length gal 0.

La proprit statique String.length renvoie la valeur 1.

Exemples

Utiliser String.length

js
const x = "Mozilla";
const vide = "";

console.log(x + " mesure " + x.length + " codets");
/* "Mozilla mesure 7 codets" */

console.log("La chane vide a une longueur de " + vide.length);
/* "La chane vide a une longueur de 0" */

Affecter une valeur length

js
const maChaine = "Sloubi";
// Lorsqu'on tente d'affecter une valeur  la proprit length
// rien d'observable ne se produit

maChaine.length = 3;
console.log(maChaine); /* Sloubi */
console.log(maChaine.length); // 6

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-properties-of-string-instances-length

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page