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 | Sí |
Numerable | No |
Configurable | No |
Sobrescribir
: si este atributo se establece enfalse
, el valor de la propiedad no se puede cambiar.Configurable
: si este atributo se establece enfalse
, cualquier intento de eliminar la propiedad o cambiar sus atributos (Sobrescribir
,Configurable
oNumerable
) fallará.Numerable
: si este atributo se establece entrue
, 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
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Soporte básico | Chrome Soporte completo Si | Edge Soporte completo Si | Firefox Soporte completo 1 | IE Soporte completo Si | Opera Soporte completo Si | Safari Soporte completo Si | WebView Android Soporte completo Si | Chrome Android Soporte completo Si | Edge Mobile Soporte completo Si | Firefox Android Soporte completo 4 | Opera Android Soporte completo Si | Safari iOS Soporte completo Si | Samsung Internet Android Soporte completo Si | nodejs Soporte completo Si |
Leyenda
- Soporte completo
- Soporte completo