A propriedade length representa o comprimento de uma string.
Sintaxe
str.lengthDescrição
Esta propriedade retorna o número de code units na string. UTF-16, o formato usado pelo JavaScript para a string, usa um single 16-bit code unit para representar os caracteres mais comuns, mas necessita de usar two code units para os caracteres menos comuns, pelo que é possível que o valor retornado por length não seja igual ao número de caracteres numa string.
Para uma string vazia, length is 0.
A propriedade estática (static) String.length retorna o valor 1.
Exemplos
Uso simples
var x = 'Mozilla';
var empty = '';
console.log('Mozilla tem de tamanho ' + x.length + ' code units');
/* "Mozilla tem de tamanho 7 code units" */
console.log('Uma string vazia tem tamanho ' + empty.length);
/* "Uma string vazia tem tamanho 0" */
Especificações
| Especificação | Estado | Comentário |
|---|---|---|
| ECMAScript 1st Edition (ECMA-262) | Standard | Definição inicial. Implementado em JavaScript 1.0. |
| ECMAScript 5.1 (ECMA-262) The definition of 'String.prototype.length' in that specification. |
Standard | |
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.prototype.length' in that specification. |
Standard |
Compatibilidade dos browsers
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
| Funcionalidade | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
| Funcionalidade | Android | Chrome para Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |