Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri