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
- 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