CKTIS / JavaScript
Iterátory Map: next(), value a done
Procházej iterátor Map pomocí `next()` a kontroluj `done`, abys odlišil uloženou hodnotu `undefined` od konce iterace.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const iterator = map.entries(); // or map.keys(), map.values(), map[Symbol.iterator]()
const { value, done } = iterator.next();Voláním iterator.next() provedeš jeden krok. Metoda patří iterátoru, nikoli objektu Map, a vrací objekt výsledku s vlastnostmi value a done. Čtení result.value iterátor neposune, další volání next() ano. Pokud potřebuješ obě vlastnosti ze stejného kroku, výsledek si ulož. Volání oddělené metody next bez správného this vyvolá TypeError.
map.keys() poskytuje klíče a map.values() uložené hodnoty. map.entries() i map[Symbol.iterator]() při každém kroku, který poskytne prvek, uloží do result.value nové dvouprvkové pole [key, value]. Všechny tři druhy procházejí položky v pořadí vložení. Kontroluj done, nikoli value: done: false znamená, že iterátor poskytl prvek, i když je value rovno undefined. Vyčerpaný iterátor Map vrací { value: undefined, done: true }.
Iterátor není snímek mapy: může zachytit položky přidané před vyčerpáním, ale jakmile vrátí done: true, už nepokračuje. Chceš-li začít od začátku, vytvoř nový iterátor. Takto se chová vestavěný Map v ECMAScriptu 2024; podpora závisí na běhovém prostředí.
Příklady
{
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));
}Výsledek
done=false, value=undefined done=false, value=7 done=true, value=undefined done=true, value=undefined ["a",null]
První krok poskytne uloženou hodnotu `undefined`, třetí ohlásí konec. Přidání `"c"` iterátor znovu nespustí. Nový iterátor položek začíná u `"a"`; v posledním řádku `JSON.stringify()` zobrazí prvek pole `undefined` jako `null`, aniž by změnil mapu.
Související lekce
- JavaScript · Lekce 7 · Pokročilá · Verze: 4
Zdroje
- 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