Array.prototype.length

La propietat length representa un nombre sencer sense signe de 32 bits que és sempre numèricament major que la última posició de l'array.

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

Sintaxi

arr.length

Descripció

El valor de la propietat length és un sencer amb un signe positiu un valor menor de 2 elevat a 32 (232).

Es pot establir la propietat length per truncar un array en qualsevol moment. Quan s'exten un array per mitjà de canviar la seva propietat length, el nombre actual d'elements no s'incrementa; per exemple, si s'estableix length a 3 quan en aquell moment és 2, l'array encara conté només 2 elements. Així, la propietat length no necessàriament indica el nombre de valors definits en l'array. Vegeu també Relació entre length i propietats numèriques.

Exemples

Recorrer un array

En l'exemple següent, es recorre l'array numbers comprovant la propietat length. Es duplica el valor de cada element.

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

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

Escurçar una array

L'exemple següent escurça l'array statesUS a una llargària de 50 en cas que la llargària actual sigui major de 50.

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

Especificacions

Especificació Estat Comentaris
ECMAScript 1st Edition (ECMA-262) Standard Definició inicial.
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  

Compatibilitat amb navegadors

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suport bàsic (Yes) (Yes) (Yes) (Yes) (Yes)
Característica Android Chrome per Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suport bàsic (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Vegeu també

Related Topics
  1. Objectes estandards
  2. Array
  3. Propietats
    1. Array.prototype.length
    2. Array.prototype
    3. Array.prototype[@@unscopables] [Traduir]
  4. Mètodes
    1. Array.from() [Traduir]
    2. Array.isArray()
    3. Array.observe()
    4. Array.of()
    5. Array.prototype.concat() [Traduir]
    6. Array.prototype.copyWithin() [Traduir]
    7. Array.prototype.entries()
    8. Array.prototype.every()
    9. Array.prototype.fill()
    10. Array.prototype.filter()
    11. Array.prototype.find()
    12. Array.prototype.findIndex()
    13. Array.prototype.flat() [Traduir]
    14. Array.prototype.flatMap() [Traduir]
    15. Array.prototype.forEach()
    16. Array.prototype.includes()
    17. Array.prototype.indexOf()
    18. Array.prototype.join()
    19. Array.prototype.keys()
    20. Array.prototype.lastIndexOf()
    21. Array.prototype.map()
    22. Array.prototype.pop()
    23. Array.prototype.push()
    24. Array.prototype.reduce()
    25. Array.prototype.reduceRight() [Traduir]
    26. Array.prototype.reverse()
    27. Array.prototype.shift()
    28. Array.prototype.slice()
    29. Array.prototype.some()
    30. Array.prototype.sort() [Traduir]
    31. Array.prototype.splice()
    32. Array.prototype.toLocaleString() [Traduir]
    33. Array.prototype.toSource() [Traduir]
    34. Array.prototype.toString() [Traduir]
    35. Array.prototype.unshift() [Traduir]
    36. Array.prototype.values() [Traduir]
    37. Array.prototype[@@iterator]() [Traduir]
    38. Array.unobserve() [Traduir]
    39. get Array[@@species] [Traduir]
  5. Herència
  6. Function
  7. Propietats
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName [Traduir]
    5. Function.length
    6. Function.prototype [Traduir]
    7. Function.name
  8. Mètodes
    1. Function.prototype.apply() [Traduir]
    2. Function.prototype.bind() [Traduir]
    3. Function.prototype.call() [Traduir]
    4. Function.prototype.isGenerator() [Traduir]
    5. Function.prototype.toSource()
    6. Function.prototype.toString() [Traduir]
  9. Object
  10. Propietats
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__ [Traduir]
    3. Object.prototype.__parent__ [Traduir]
    4. Object.prototype.__proto__ [Traduir]
    5. Object.prototype.constructor [Traduir]
  11. Mètodes
    1. Object.prototype.__defineGetter__() [Traduir]
    2. Object.prototype.__defineSetter__() [Traduir]
    3. Object.prototype.__lookupGetter__() [Traduir]
    4. Object.prototype.__lookupSetter__() [Traduir]
    5. Object.prototype.hasOwnProperty() [Traduir]
    6. Object.prototype.isPrototypeOf() [Traduir]
    7. Object.prototype.propertyIsEnumerable() [Traduir]
    8. Object.prototype.toLocaleString() [Traduir]
    9. Object.prototype.toSource() [Traduir]
    10. Object.prototype.toString() [Traduir]
    11. Object.prototype.unwatch() [Traduir]
    12. Object.prototype.valueOf() [Traduir]
    13. Object.prototype.watch() [Traduir]
    14. Object.setPrototypeOf() [Traduir]