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

CKTIS / JavaScript

Longitud e indexación de arrays en JavaScript

`length` marca el límite de los índices de un array, pero no cuenta sus elementos. Escribir en un índice puede ampliar ese límite, y un hueco no equivale a `undefined`.

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

Sintaxis

a.length; a[i]; a[i] = value; a.length = n; delete a[i]; Object.hasOwn(a, i); a.at(i);

Los índices de un array empiezan en cero. a.length es una propiedad propia, escribible por defecto pero no configurable. Su valor es un entero de 0 a 2 ** 32 - 1. Es el límite superior excluido de los índices de elementos propios, no un recuento de elementos. En cambio, Array.length indica cuántos parámetros espera la función constructora, no la longitud de un array.

Los corchetes acceden a propiedades: a[1] y a["1"] usan la misma clave. Los índices son las representaciones decimales canónicas de los enteros de 0 a 2 ** 32 - 2. Claves como "01", "-1" y "4294967295" no son índices y no alteran la longitud. a[-1] busca la propiedad "-1"; a.at(-1) lee la última posición de un array no vacío. Si el índice calculado queda fuera del intervalo, at() devuelve undefined sin buscar esa propiedad.

Crear un elemento propio en i >= a.length amplía la longitud a i + 1. Las posiciones saltadas quedan como huecos. Un hueco carece de propiedad propia; al leerlo se obtiene undefined salvo que se herede un valor. Object.hasOwn(a, i) distingue un hueco de un elemento propio cuyo valor es undefined. Si delete a[i] tiene éxito, elimina el elemento sin acortar el array.

Aumentar length añade huecos; reducirla elimina los elementos propios a partir del nuevo límite. Si length es escribible, asignarle un valor de tipo Number que no sea entero o que esté fuera del intervalo permitido lanza RangeError. Asignarle un valor de tipo BigInt, en cambio, lanza TypeError durante la conversión, antes de comprobar el intervalo. Un elemento no configurable puede bloquear el truncamiento: es posible que ya se hayan eliminado elementos de índices mayores, y la longitud queda en el índice que bloquea la operación más uno. En modo estricto, esa asignación fallida lanza TypeError.

Ejemplos

{
  const a = ["A"];
  a[3] = "D";
  a[2] = undefined;
  a[-1] = "tag";

  console.log(`length: ${a.length}`);
  console.log(`1: ${a[1]}, own: ${Object.hasOwn(a, 1)}`);
  console.log(`2: ${a[2]}, own: ${Object.hasOwn(a, 2)}`);
  console.log(`[-1]: ${a[-1]}, at(-1): ${a.at(-1)}`);

  a.length = 1;
  a.length = 4;
  console.log(`length: ${a.length}, own 3: ${Object.hasOwn(a, 3)}, [-1]: ${a[-1]}`);
}

Resultado

length: 4
1: undefined, own: false
2: undefined, own: true
[-1]: tag, at(-1): D
length: 4, own 3: false, [-1]: tag

Leer las posiciones `1` y `2` da `undefined`, pero solo `2` es un elemento propio. Al ampliar de nuevo el array no se recupera el elemento `3`; la propiedad `"-1"` se conserva.

Lecciones relacionadas

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

Fuentes