Artigos JavaScript JavaScript length: como e quando utilizar essa propriedade

JavaScript length

Nesta documentação de JavaScript veremos como utilizar a propriedade length para obter o tamanho de uma String ou de um array.

Apresentaremos aqui como utilizar o método length.

JavaScript length: Na prática
// Valor retornado: 25
stringExemplo = "JavaScript é na DevMedia!"
stringExemplo.length;

// Valor retornado: 6
carros = ["Civic", "Elantra", "Focus", "Jetta", "Cruze", "Corolla"];
carros.length;

// Valor impresso: “String vazia!”
stringExemplo ="";

if (stringExemplo.length == 0) {
         console.log("String vazia!");
}

// Valor impresso: “A senha precisa ter pelo menos seis caracteres.”
var senha = "12345";

if (senha.length < 6) {
         console.log("A senha precisa ter pelo menos seis caracteres.");
}

// Valor impresso: “CPF com tamanho correto!”
cpfExemplo ="123.456.789-12";

if (cpfExemplo.length == 14) {
         console.log("CPF com tamanho correto!");
} else {
         console.log("Verificar campo CPF");
}

// Valor impresso: “Civic Elantra Focus Jetta Cruze Corolla”
carros = ["Civic", "Elantra", "Focus", "Jetta", "Cruze", "Corolla"];

for (var pos = 0; pos < carros.length; pos++) {
         console.log(carros[pos]);
}

Como funciona a propriedade length?

A propriedade length tem como responsabilidade retornar a quantidade de caracteres de uma string ou o tamanho de um array. Caso a string ou o array esteja vazio, é retornado o valor 0. Considerando o seguinte código:

var stringExemplo = "Aprendendo JavaScript na DevMedia!";
var tamanho = stringExemplo.length;

O valor atribuído à variável tamanho será o número 34, conforma a Figura 1.

Valor atribuído à propriedade length
Figura 1. Funcionamento da propriedade length

Sintaxe

string.length

Exemplos de length

Exemplo 1

No exemplo a seguir demonstramos como obter o tamanho de uma string:

var stringExemplo = "Texto qualquer";
var tamanho = stringExemplo.length;

O valor atribuído a tamanho é: 14.

Run!
Exemplo 2

No exemplo a seguir demonstramos como utilizar a propriedade length quando é preciso conhecer o tamanho de um array:

var carros = ["Civic", "Elantra", "Focus", "Jetta", "Cruze", "Corolla"];
var tamanho = carros.length;

O valor atribuído a tamanho é: 6.

Run!
Exemplo 3

No exemplo a seguir demonstramos como verificar se uma string está vazia, algo que precisa ser validado em formulários e pode prejudicar o funcionamento da aplicação:

var stringExemplo ="";

if (stringExemplo.length == 0) {
         console.log("String vazia!");
}

A execução desse código imprime a mensagem: “String vazia!”.

Run!
Exemplo 4

Também podemos utilizar a propriedade para validar o tamanho de uma senha:

var senha = "abcde";

if (senha.length < 6) {
   console.log("A senha precisa ter pelo menos 6 (seis) caracteres.");
}

Ao executar esse código é impresso no console: "A senha precisa ter pelo menos seis caracteres.".

Run!
Exemplo 5

No exemplo a seguir demonstramos como fazer uma validação simples de CPF:

var cpfExemplo ="123.456.789-12";

if (cpfExemplo.length == 14) {
         console.log("CPF com tamanho correto!");
} else {
         console.log("Verificar campo CPF");
}

Ao executar esse código é impressa a mensagem: “CPF com tamanho correto!”.

Run!
Exemplo 6

No exemplo a seguir demonstramos como iterar sobre um array utilizando a propriedade length.

var carros = ["Civic", "Elantra", "Focus", "Jetta", "Cruze", "Corolla"];

for (var pos = 0; pos < carros.length; pos++) {
         console.log(carros[pos]);
}

Ao executar esse código são impressos todos os itens do array.

Run!

Compatibilidade entre navegadores

length é suportada por todos os browsers apresentados na Tabela 1.

length Chrome Firefox IE Edge Safari Opera
Sim Sim Sim Sim Sim Sim

Tabela 1. Compatibilidade da propriedade x browsers.

Veja também