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

CKTIS / JavaScript

Iteradores de Map: next(), value y done

Avanza por un iterador de Map con `next()` y comprueba `done` para distinguir un valor `undefined` almacenado del fin de la iteración.

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

Sintaxis

const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();

Llama a iterator.next() para avanzar un paso. El método pertenece al iterador, no al Map, y devuelve un objeto de resultado con value y done. Leer result.value no hace avanzar el iterador; volver a llamar a next() sí. Guarda el resultado si necesitas ambas propiedades del mismo paso. Si extraes next y lo llamas sin el this adecuado, se produce un TypeError.

map.keys() produce las claves y map.values() los valores almacenados. En cada paso que produce un elemento, map.entries() y map[Symbol.iterator]() entregan un nuevo array de dos elementos [key, value] en result.value. Los tres tipos recorren las entradas en orden de inserción. Comprueba done, no value: done: false indica que se obtuvo un elemento, aunque value sea undefined. Un iterador de Map agotado devuelve { value: undefined, done: true }.

El iterador no es una copia fija: puede ver entradas añadidas antes de agotarse, pero no vuelve a avanzar una vez que devuelve done: true. Crea otro iterador para empezar de nuevo. Así se comporta el Map incorporado en ECMAScript 2024; la compatibilidad depende del entorno de ejecución.

Ejemplos

{
  const map = new Map([["a", undefined], ["b", 7]]);
  const iterator = map.values();

  function logStep({ value, done }) {
    console.log(`done=${done}, value=${value}`);
  }

  logStep(iterator.next());
  logStep(iterator.next());
  logStep(iterator.next());

  map.set("c", 9);
  logStep(iterator.next());
  console.log(JSON.stringify(map.entries().next().value));
}

Resultado

done=false, value=undefined
done=false, value=7
done=true, value=undefined
done=true, value=undefined
["a",null]

El primer paso entrega un `undefined` almacenado; el tercero indica el fin. Añadir `"c"` no reactiva el iterador. Un iterador de entradas nuevo empieza en `"a"`; en la última línea, `JSON.stringify()` representa el elemento `undefined` del array como `null` sin modificar el Map.

Lecciones relacionadas

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

Fuentes