String.length

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

Compatibilidade dos browsers

Ver também

• JavaScript String.length and Internationalizing Web Applications