Array.prototype.length

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

A propriedade length representa um inteiro de 32-bit sem sinal, que especifíca o número de elementos em um array.

Property attributes of Array.prototype.length
Writable yes
Enumerable no
Configurable no

Sintaxe

arr.length

Descrição

O valor da propriedade length é um inteiro com um sinal positivo e valor menor que 2 elevado na 32ª potência(232).

Você pode setar o a propriedade length para truncar um array a qualquer momento. Quando você extende um array mudando sua propriedade length, o numero de elementos atuais não é incrementado; por exemplo, se você setar o tamanho para 3 quando ele é atualmente 2, o array continua somente com 2 elementos. Assim, a propriedade lenght não diz nada sobre o tamanho de valores definidos no array. Veja também Relacionamento entre length e propriedades numéricas.

Exemplos

Iterando sobre um array

No exemplo a seguir numbers é iterado considerando a propriedade length para ver quantos elementos ele tem. O valor de cada elemento recebe então o dobro.

var numbers = [1, 2, 3, 4, 5];

for (var i = 0; i < numbers.length; i++) {
  numbers[i] *= 2;
}
// numbers is now [2, 4, 6, 8, 10]

Encurtando um array

O exemplo a seguir encurta o array  statesUS para um tamanho de 50 se o tamanho corrente for maior do que 50.

if (statesUS.length > 50) {
  statesUS.length = 50;
}

Especificações

Specification Status Comment
ECMAScript 1st Edition (ECMA-262) Standard Initial definition.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.length' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.length' in that specification.
Standard  

Compatibilidade de Browser

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: jouderianjr, lnmunhoz, icaromh
 Última atualização por: jouderianjr,