CKTIS / JavaScript
Longitud de un array: Array.length
La propiedad length indica la longitud de un array, pero no necesariamente el número de elementos existentes. Asignarle un valor puede eliminar elementos o aumentar la longitud sin rellenar las nuevas posiciones.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
array.length
array.length = newLengthArray.length designa aquí la propiedad length de una instancia de array, que se lee como array.length, no la propiedad del constructor Array. Es una propiedad, no un método. Su valor es un entero entre 0 y 2 ** 32 - 1, ambos incluidos.
La longitud no cuenta los elementos existentes: un array puede contener posiciones vacías. Si una asignación crea un elemento en un índice del array igual o superior a la longitud actual, length aumenta hasta ese índice más uno. Si length se ha configurado como no escribible, esa asignación no añade el elemento ni aumenta la longitud del array: en modo estricto lanza un TypeError y, fuera de ese modo, falla silenciosamente. delete array[i] elimina el elemento si es una propiedad propia y configurable del array, pero no reduce la longitud. Si la propiedad propia en ese índice no es configurable, no se elimina: delete devuelve false fuera del modo estricto y lanza un TypeError en modo estricto.
Asignar una longitud menor elimina los elementos propios cuyos índices son mayores o iguales que la nueva longitud. Aumentarla no crea elementos con el valor undefined; deja posiciones vacías. En el ejemplo, escribir en el índice 4 establece la longitud en 5, y reducirla después a 2 elimina ese elemento.
Si una asignación a array.length llega a la validación de la nueva longitud, un número negativo, una fracción no entera, NaN, Infinity o 2 ** 32 provoca un RangeError. Si length no es escribible, la asignación se rechaza sin validar la nueva longitud: en modo estricto lanza un TypeError y, fuera de ese modo, falla silenciosamente. Inicialmente, length es escribible, no enumerable y no configurable. Un elemento no configurable puede impedir el truncamiento: la longitud se detiene en su índice más uno. En modo estricto, esa asignación lanza un TypeError, y es posible que los elementos de índices superiores ya se hayan eliminado.
Ejemplos
const items = [10, 20];
items[4] = 50;
console.log(items.length);
console.log(Object.hasOwn(items, 2));
items.length = 2;
console.log(JSON.stringify(items));
items.length = 4;
console.log(items.length);
console.log(Object.hasOwn(items, 2));Resultado
5 false [10,20] 4 false
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.