Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
Array.prototype.length
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
A propriedadelength representa um inteiro de 32-bit sem sinal, que especifíca o número de elementos em um array.
Property attributes ofArray.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 propriedadelength para truncar um array a qualquer momento. Quando você extende um array mudando sua propriedadelength, 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 propriedadelength não diz nada sobre o tamanho de valores definidos no array. Veja tambémRelacionamento entrelength e propriedades numéricas.
Exemplos
Iterando sobre um array
No exemplo a seguirnumbers é iterado considerando a propriedadelength 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 arraystatesUS para um tamanho de 50 se o tamanho corrente for maior do que 50.
if (statesUS.length > 50) { statesUS.length = 50;}Especificações
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-properties-of-array-instances-length |