A propriedade length
representa o comprimento de uma string.
Sintaxe
str.length
Descriçã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) |