[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Array/length [Back]  [Original]

Array.prototype.length - JavaScript | MDN

Esta pgina foi traduzida do ingls pela comunidade. Saiba mais e junte-se comunidade MDN Web Docs.

View in English Always switch to English

Array.prototype.length

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since julho de 2015.

A propriedade length representa um inteiro de 32-bit sem sinal, que especifca o nmero de elementos em um array.

Property attributes of Array.prototype.length
Writableyes
Enumerableno
Configurableno

In this article

Sintaxe

arr.length

Descrio

O valor da propriedade length um inteiro com um sinal positivo e valor menor que 2 elevado na 32 potncia(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 no incrementado; por exemplo, se voc setar o tamanho para 3 quando ele atualmente 2, o array continua somente com 2 elementos. Assim, a propriedade length no diz nada sobre o tamanho de valores definidos no array. Veja tambm Relacionamento entre length e propriedades numricas.

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 ento o dobro.

js
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.

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

Especificaes

Specification
ECMAScript 2027 LanguageSpecification
# sec-properties-of-array-instances-length

Compatibilidade com navegadores

Veja tambm


Web Proxy Viewer  |  New URL  |  Original Page