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