CKTIS / JavaScript
Array.prototype.values: iterator vrednosti
values vrne živ iterator, ki bere zaporedne indeksirane vrednosti, vključno z undefined iz lukenj.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
array.values()array.values() ustvari iterator vrednosti brez kopiranja elementov. Vsak next() prebere trenutni indeks in znova preveri length, zato so lahko vidne spremembe prejemnika pred obiskom položaja. Rezultat koraka vsebuje value in done; ko je iterator izčrpan, ostane izčrpan.
Luknje se ne preskočijo: običajno branje manjkajočega indeksa vrne undefined. Iterator je tudi sam iterabilen, Array.prototype[Symbol.iterator] pa sprva kaže na isto funkcijo kot values. Metoda ne mutira in je splošna za array-like vrednosti.
Ustvarjanje zahteva prejemnika, ki ni null ali undefined, sicer sproži TypeError. Pretvorba length, indeksirani getterji in proxy pasti se izvajajo med iteracijo, zato njihove napake pridejo iz next(). API je bil standardiziran v ECMAScript 2015.
Primeri
const sparse = ["build", , "deploy"];
const iterator = sparse.values();
for (let step = iterator.next(); !step.done; step = iterator.next()) {
console.log(String(step.value), step.done);
}
console.log(iterator.next().done);
const tasks = ["test"];
const live = tasks.values();
console.log(live.next().value);
tasks.push("release");
console.log(live.next().value, live.next().done);Rezultat
build false undefined false deploy false true test release true