Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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