La propiedad length de un objeto que es una instancia de tipo Array establece o devuelve la cantidad de elementos en esa matriz. El valor es un entero sin signo de 32 bits que siempre es numéricamente mayor que el índice más alto en la matriz.

Descripción

El valor de la propiedad length es un número entero con un signo positivo y un valor menor que 2 a la 32a potencia (232).

var namelistA = new Array(4294967296); //2 a la 32a potencia = 4294967296 
var namelistC = new Array(-100) //signo negativo

console.log(namelistA.length); //RangeError: longitud de la matriz inválida 
console.log(namelistC.length); //RangeError: longitud de la matriz inválida 



var namelistB = []; 
namelistB.length = Math.pow(2,32)-1; //establecer una longitud de la matriz menor que 2 a la 32ª potencia  
console.log(namelistB.length); 

//4294967295

Puedes establecer la propiedad length para truncar una matriz unidimensional en cualquier momento. Cuando extiende una matriz cambiando su propiedad length, el número de elementos reales aumenta; por ejemplo, si se establece length en 3 cuando actualmente es 2, la matriz ahora contiene 3 elementos, lo que hace que el tercer elemento sea undefined.

var arr = [1, 2, 3];
printEntries(arr);

arr.length = 5; // establecer la longitud de la matriz en 5 mientras que actualmente es 3.
printEntries(arr);

function printEntries(arr) {
  var length = arr.length;
  for (var i = 0; i < length; i++) {
    console.log(arr[i]);
  }
  console.log('=== printed ===');
}

// 1
// 2
// 3
// === impreso ===
// 1
// 2
// 3
// undefined
// undefined
// === impreso ===

Pero, la propiedad length no necesariamente indica el número de valores definidos en la matriz. Ver también Relación entre length y las propiedades numéricas.

Atributos de la propiedad Array.prototype.length
Sobrescribir
Numerable No
Configurable No

  • Sobrescribir: si este atributo se establece en false, el valor de la propiedad no se puede cambiar.
  • Configurable: si este atributo se establece en false, cualquier intento de eliminar la propiedad o cambiar sus atributos (Sobrescribir, Configurable o Numerable) fallará.
  • Numerable: si este atributo se establece en true, la propiedad se repetirá durante los bucles for o for..in.

Ejemplos

Iterando sobre una matriz

En el siguiente ejemplo, la matriz numbers se itera a través de la propiedad length. El valor en cada elemento se duplica.

var numbers = [1, 2, 3, 4, 5];
var length = numbers.length;
for (var i = 0; i < length; i++) {
  numbers[i] *= 2;
}
// numbers ahora es [2, 4, 6, 8, 10]

Acortando una matriz

El siguiente ejemplo acorta los numbers de la matriz a una longitud de 3 si la longitud actual es mayor que 3.

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

if (numbers.length > 3) {
  numbers.length = 3;
}

console.log(numbers); // [1, 2, 3]
console.log(numbers.length); // 3

Especificaciones

Especificación Estado Comentario
ECMAScript 1ra Edición. Estándar Definición inicial.
ECMAScript 5.1 (ECMA-262)
La definición de 'Array.length' en esta especificación.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'Array.length' en esta especificación.
Standard  
ECMAScript Latest Draft (ECMA-262)
La definición de 'Array.length' en esta especificación.
Draft  

Compatibilidad con navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
Soporte básicoChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 1IE Soporte completo SiOpera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo SiSafari iOS Soporte completo SiSamsung Internet Android Soporte completo Sinodejs Soporte completo Si

Leyenda

Soporte completo  
Soporte completo
 

Ver también

Etiquetas y colaboradores del documento

Colaboradores en esta página: lajaso, abaracedo, gfernandez, martinweingart
Última actualización por: lajaso,