Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

A length é a propriedade de um objeto String representa o comprimento de uma string no codigo UTF-16.

Sintaxe

str.length

Descrição

Essa propriedade retorna o número de unidades de código presentes na string. UTF-16, a codificação utilizada pelo JavaScript, utiliza uma unidade de código de 16-bits para representar os caracteres mais comuns, mas precisa usar duas unidades para caracteres menos usados, então é possível que o valor retornado por length não seja exatamente o número de caracteres na string.

ECMASCript 2016 (ed. 7) estabeleceu um comprimento máximo de 2^53 - 1 elementos. Anteriormente, nenhum comprimento máximo foi especificado.

Para uma string vazia, length é 0.

A propriedade estática String.length retorna o valor 1.

Exemplos

Uso básico

var x = 'Mozilla';
var empty = '';

console.log('Mozilla possui ' + x.length + ' unidades de código de comprimento');
/* "Mozilla possui 7 unidades de código de comprimento" */

console.log('A string vazia possui um comprimento de ' + empty.length);
/* "A string vazia possui um comprimento de 0" */

Especificação

Especificação Estado Comentários
ECMAScript 1st Edition (ECMA-262) Padrão Definição inicial. Implementada no JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.length' in that specification.
Padrão  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.length' in that specification.
Padrão  

Compatibilidade de Browsers (Navegadores)

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes)
Característica Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: Gemacedo, solangealmn, fernandomalmeida
Última atualização por: Gemacedo,