Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Protokol iterátora: next(), return(), value a done

Koniec iterácie zistíš podľa `done`, nie podľa `value`. Nauč sa, ako prečítať koncovú hodnotu a kedy `for...of` volá voliteľnú metódu `return()`.

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

Syntax

const iterator = iterable[Symbol.iterator]();
const result = iterator.next();
// result.done: completion flag; result.value: element or completion value
// When stopping early during manual iteration, call the optional method if callable:
if (typeof iterator.return === "function") {
  iterator.return();
}

Synchrónny iterátor je objekt s metódou next(), ktorá vracia objekt výsledku (IteratorResult). Iterovateľný objekt má metódu [Symbol.iterator](), ktorá vracia iterátor. Samotná metóda next() nerobí objekt iterovateľným; objekt generátora spĺňa obe úlohy. for...of získa iterátor a volá next() bez argumentov. Význam prípadného argumentu závisí od implementácie iterátora.

Pri done: false je value prvok, aj keď má hodnotu undefined. done: true označuje koniec iterácie; value potom môže obsahovať koncovú hodnotu, ktorú for...of neodovzdá telu cyklu. Chýbajúce done sa považuje za false; for...of pri teste prevedie túto vlastnosť na logickú hodnotu. Po vyčerpaní iterátora by ďalšie volania next() mali naďalej hlásiť done: true, jazyk to však nevynucuje.

Voliteľná metóda return(value) oznamuje, že volajúci končí, a dáva iterátoru možnosť uvoľniť prostriedky. Výsledok zvyčajne obsahuje done: true a odovzdaný argument ako value. Generátor však môže vrátiť done: false, ak v bloku finally vykoná yield. Pri predčasnom opustení cyklu pomocou break alebo pre výnimku z jeho tela zavolá for...of dostupné return() bez argumentov a ignoruje done aj value výsledku. Nevolá ho pri normálnom vyčerpaní iterátora ani vtedy, keď výnimku vyvolá samotné next().

Ručné volanie next() iterátor automaticky neuzatvára. Ak skončíš predčasne, zavolaj return(), pokiaľ je volateľné. for...of vyvolá TypeError, ak next() alebo volanie return() pri uzatváraní nevráti objekt. Ak uzatváranie spustila výnimka z tela cyklu, prednosť má pôvodná výnimka.

Príklady

{
  function* sequence() {
    try {
      yield undefined;
      return "end";
    } finally {
      console.log("cleanup");
    }
  }

  function show(label, { done, value }) {
    console.log(`${label}: done=${done}, value=${value}`);
  }

  const full = sequence();
  show("next", full.next());
  show("next", full.next());
  show("next", full.next());

  for (const value of sequence()) {
    console.log(`loop: ${value}`);
    break;
  }

  const manual = sequence();
  manual.next();
  show("return", manual.return("stopped"));
}

Výsledok

next: done=false, value=undefined
cleanup
next: done=true, value=end
next: done=true, value=undefined
loop: undefined
cleanup
cleanup
return: done=true, value=stopped

Tri samostatné generátory ukazujú normálne vyčerpanie s koncovou hodnotou `end`, automatické uzatvorenie pri `break` a výslovné volanie `return("stopped")`. Každý spustený generátor vypíše v bloku `finally` text `cleanup`.

Súvisiace lekcie

  • JavaScript · Lekcia 8 · Pokročilá · Verzia: 4

Zdroje