Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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