Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Iterator Map: next(), value i done

Pobieraj kolejne elementy z iteratora Map za pomocą `next()` i sprawdzaj `done`, aby odróżnić zapisaną wartość `undefined` od końca iteracji.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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

Wywołaj iterator.next(), aby wykonać jeden krok. Metoda należy do iteratora, nie do obiektu Map, i zwraca obiekt wyniku z właściwościami value oraz done. Odczyt result.value nie przesuwa iteratora, ale każde kolejne wywołanie next() wykonuje nowy krok. Zachowaj wynik, jeśli potrzebujesz obu właściwości z tego samego kroku. Wywołanie odłączonej metody next bez właściwego this powoduje TypeError.

map.keys() zwraca iterator kluczy, a map.values() — iterator zapisanych wartości. Iteratory z map.entries() i map[Symbol.iterator]() zwracają przy każdym udanym kroku nową dwuelementową tablicę [key, value] jako result.value. Wszystkie przechodzą po wpisach w kolejności wstawiania. Sprawdzaj done, a nie value: done: false oznacza, że otrzymano element, nawet jeśli value to undefined. Po wyczerpaniu iterator Map zwraca { value: undefined, done: true }.

Iterator nie jest migawką mapy: może uwzględnić wpisy dodane przed wyczerpaniem, ale po zwróceniu done: true już się nie wznowi. Aby zacząć od początku, utwórz nowy iterator. To zachowanie wbudowanego Map w ECMAScript 2024; obsługa zależy od środowiska uruchomieniowego.

Przykłady

{
  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));
}

Wynik

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

Pierwszy krok zwraca zapisaną wartość `undefined`, a trzeci sygnalizuje koniec. Dodanie `"c"` nie wznawia iteratora. Nowy iterator wpisów zaczyna od `"a"`; w ostatnim wierszu `JSON.stringify()` zamienia `undefined` wewnątrz tablicy na `null`, ale nie zmienia mapy.

Powiązane lekcje

  • JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4

Źródła