Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de 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 julio de 2015.
La propiedadlength 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.
In this article
Pruébalo
const clothing = ["shoes", "shirts", "socks", "sweaters"];console.log(clothing.length);// Expected output: 4Descripción
El valor de la propiedadlength 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 = 4294967296var namelistC = new Array(-100); //signo negativoconsole.log(namelistA.length); //RangeError: longitud de la matriz inválidaconsole.log(namelistC.length); //RangeError: longitud de la matriz inválidavar namelistB = [];namelistB.length = Math.pow(2, 32) - 1; //establecer una longitud de la matriz menor que 2 a la 32ª potenciaconsole.log(namelistB.length);//4294967295Puedes establecer la propiedadlength para truncar una matriz unidimensional en cualquier momento. Cuando extiende una matriz cambiando su propiedadlength, el número de elementos reales aumenta; por ejemplo, si se establecelength en 3 cuando actualmente es 2, la matriz ahora contiene 3 elementos, lo que hace que el tercer elemento seaundefined.
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 propiedadlength no necesariamente indica el número de valores definidos en la matriz. Ver tambiénRelación entrelength y las propiedades numéricas.
Atributos de la propiedadArray.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,ConfigurableoNumerable) fallará.Numerable: si este atributo se establece entrue, la propiedad se repetirá durante los buclesfor ofor..in.
Ejemplos
>Iterando sobre una matriz
En el siguiente ejemplo, la matriznumbers se itera a través de la propiedadlength. 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 losnumbers de la matriz a una longitud de3 si la longitud actual es mayor que3.
var numbers = [1, 2, 3, 4, 5];if (numbers.length > 3) { numbers.length = 3;}console.log(numbers); // [1, 2, 3]console.log(numbers.length); // 3Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-properties-of-array-instances-length> |