CKTIS / JavaScript
Symbol.asyncIterator — protokol asinkrone iteracije
Symbol.asyncIterator ugrađeni je simbol koji označava metodu kojom objekt pruža svoj asinkroni iterator. Omogućuje da for await...of dohvaća uzastopne vrijednosti čekajući rezultate poziva next().
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
Symbol.asyncIterator
object[Symbol.asyncIterator]()
async *[Symbol.asyncIterator]() { /* yield values */ }Symbol.asyncIterator poznati je simbol koji se upotrebljava kao ključ svojstva, a ne funkcija koja se izravno poziva. Metoda object[Symbol.asyncIterator]() vraća asinkroni iterator — sam objekt iteratora, a ne obećanje koje sadrži iterator. Ovaj je mehanizam dio ECMAScripta od ECMAScript 2018 (ES2018); nije Web API.
Asinkrono iterabilan objekt pruža tu metodu, dok asinkroni iterator ima metodu next(), koja vraća obećanje koje se ispunjava objektom rezultata. Ako svojstvo done nedostaje, rezultat se tumači kao da sadrži done: false. Rezultat s done: true označava kraj iteracije i ne mora sadržavati svojstvo value. Sintaksa async *[Symbol.asyncIterator]() definira metodu asinkronog generatora koja automatski podržava ovaj protokol.
Petlja for await...of najprije traži Symbol.asyncIterator. Ako metoda ne postoji ili ima vrijednost null, upotrebljava Symbol.iterator i prilagođava sinkroni iterator. Obična petlja for...of ne upotrebljava Symbol.asyncIterator. Tvorničku metodu iteratora nemoj deklarirati kao običnu metodu async: vratila bi obećanje umjesto iteratora.
U primjeru svaki poziv metode stvara novi generator, a petlja prikuplja vrijednosti redom. Provjeri podršku za sintaksu i simbol u ciljnom okruženju; ni sama prisutnost Symbol.asyncIterator ni upotreba Nodea 24 u repozitoriju ne dokazuju kompatibilnost s preglednicima.
Primjeri
const numbers = {
async *[Symbol.asyncIterator]() {
yield 1;
yield 2;
yield 3;
}
};
async function main() {
const values = [];
for await (const value of numbers) {
values.push(value);
}
console.log(values.join(', '));
}
main().catch(console.error);Rezultat
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.