CKTIS / JavaScript
Iteradores de Map: next(), value e done
Percorre um iterador de Map com `next()` e verifica `done` para distinguir um valor `undefined` guardado do fim da iteração.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Chama iterator.next() para avançar um passo. O método pertence ao iterador, não ao Map, e devolve um objeto de resultado com value e done. Ler result.value não faz avançar o iterador; voltar a chamar next() faz. Guarda o resultado se precisares das duas propriedades do mesmo passo. Chamar o método next em separado, sem o this correto, lança um TypeError.
map.keys() produz as chaves e map.values() os valores guardados. A cada passo que produz um elemento, map.entries() e map[Symbol.iterator]() fornecem um novo array de dois elementos [key, value] em result.value. Os três tipos percorrem as entradas pela ordem de inserção. Verifica done, não value: done: false indica que foi produzido um elemento, mesmo que value seja undefined. Um iterador de Map esgotado devolve { value: undefined, done: true }.
O iterador não é uma cópia fixa: pode ver entradas adicionadas antes de se esgotar, mas não volta a avançar depois de devolver done: true. Cria um novo iterador para recomeçar. Este é o comportamento do Map integrado em ECMAScript 2024; o suporte varia conforme o ambiente de execução.
Exemplos
{
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]
O primeiro passo produz um `undefined` guardado; o terceiro assinala o fim. Adicionar `"c"` não reativa o iterador. Um novo iterador de entradas começa em `"a"`; na última linha, `JSON.stringify()` representa o elemento `undefined` do array como `null`, sem alterar o Map.
Lições relacionadas
- JavaScript · Lição 7 · Avançado · Versão: 4
Fontes
- 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