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

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)

Ver também