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
- ECMAScript 2024 Language Specification — Map Iterator Objects
- ECMAScript Language Specification — Properties of the Map Prototype Object
- ECMAScript Language Specification — Map Iterator Objects
- ECMAScript 2024 Language Specification — GeneratorResume
- ECMAScript 2024 Language Specification — GeneratorValidate