Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

`length`: la propiedad modificable de un array

Lee `arr.length` para obtener la longitud del array o asígnale un valor para acortar ese mismo array o alargarlo sin crear elementos.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

arr.length
arr.length = newLength

arr.length es una propiedad de datos propia de una instancia de Array, no la propiedad length del constructor Array. Al principio admite escritura, pero no es enumerable ni configurable. Su valor es mayor que cualquier índice propio del array y puede superar el número de elementos presentes.

Reducir length elimina los elementos propios cuyo índice es igual o superior a la nueva longitud. arr.length = 0 vacía un array normal sin reemplazarlo: el cambio es visible desde todas las referencias al mismo array. Aumentar la longitud deja huecos, no elementos con el valor undefined, y no recupera elementos eliminados. Crear un elemento en un índice válido i igual o superior a la longitud actual la aumenta a i + 1.

La longitud es un entero de tipo Number entre 0 y 2 ** 32 - 1, ambos incluidos. Al escribir en una propiedad length que admite escritura, se convierte el valor asignado: por ejemplo, "3" se acepta como 3, pero 2.5, -1 y 2 ** 32 provocan un RangeError. Convertir un Symbol o un BigInt provoca en cambio un TypeError.

Si al acortar el array se encuentra un elemento no configurable, el proceso se detiene en ese índice. La longitud queda en ese índice más uno y los elementos de índices superiores ya eliminados no se recuperan. También puedes impedir permanentemente la escritura en length con writable: false. Esto impide las asignaciones a length y añadir elementos que alargarían el array, pero no impide todos los cambios en los elementos. En ambos casos, una asignación fallida provoca un TypeError en modo estricto; fuera de ese modo, no lanza una excepción.

Ejemplos

(() => {
  "use strict";
  const arr = ["a", "b", "c"];
  const alias = arr;

  arr.length = 1;
  console.log(`${alias.length}: ${alias.join(",")}`);

  arr.length = 3;
  arr[2] = undefined;
  console.log(`${arr.length}: ${Object.hasOwn(arr, 1)}, ${Object.hasOwn(arr, 2)}`);

  arr[4] = "e";
  console.log(`${arr.length}: ${arr[4]}`);

  try {
    arr.length = 2.5;
  } catch (error) {
    console.log(`${error.name}: ${arr.length}`);
  }
})();

Resultado

1: a
3: false, true
5: e
RangeError: 5

`alias` permite observar que el mismo array se acorta. Tras alargarlo, `Object.hasOwn` distingue el hueco del índice `1` del valor `undefined` asignado explícitamente al índice `2`. Escribir en el índice `4` eleva la longitud a `5`; rechazar `2.5` no la cambia.

Lecciones relacionadas

  • JavaScript · Lección 20 · Avanzado · Versión: 4

Fuentes