Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Symbol.iterator — sinkroni iteracijski protokol

Symbol.iterator je poznati simbol koji označava metodu za stvaranje iteratora. Omogućuje da prilagođeni objekt radi s for...of i proširivanjem polja. Iterabilni objekt daje iterator, a iterator putem next() daje uzastopne rezultate.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

iterable[Symbol.iterator]()
({ [Symbol.iterator]() { return iterator; } })

Symbol.iterator je poznati simbol, a ne funkcija. On je ključ metode [Symbol.iterator]() iterabilnog objekta (iterable). Ta metoda vraća iterator koji, među ostalim, upotrebljavaju for...of i proširivanje polja ([...iterable]). Ključ niza znakova "Symbol.iterator" nije isti ključ.

Iterabilni objekt pruža tu metodu, dok iterator ima metodu next(). Svaki poziv metode next() mora vratiti objekt rezultata: done označava je li iteracija završena, a value sadrži trenutačni element dok se iteracija nastavlja. Kada je done: true, potrošači poput for...of ne obrađuju value kao element. Sama metoda next() ne čini objekt iterabilnim.

U primjeru svaki poziv [Symbol.iterator]() stvara zaseban brojač. Zato oba proširivanja daju 1,2,3. Iterator ne mora i sam biti iterabilan; ako treba biti, može pružiti [Symbol.iterator]() koji vraća this. Vraćanje istog iteratora ne jamči da će iteracija krenuti ispočetka.

Običan objekt ne postaje iterabilan samo zato što ima svojstva. Neispravna implementacija, primjerice ona koja iz next() vraća broj umjesto objekta, uzrokuje TypeError pri upotrebi protokola. Taj je mehanizam sinkron; asinkroni protokol koristi zaseban simbol Symbol.asyncIterator.

Primjeri

const numbers = {
  [Symbol.iterator]() {
    let current = 1;
    return {
      next() {
        if (current <= 3) {
          return { value: current++, done: false };
        }
        return { done: true };
      }
    };
  }
};

console.log([...numbers].join(','));
console.log([...numbers].join(','));

Rezultat

1,2,3
1,2,3

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori