Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Array.prototype.values: iterator vrijednosti

values vraća živi iterator koji čita uzastopne indeksirane vrijednosti, uključujući undefined iz rupa.

Verzija: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaksa

array.values()

array.values() stvara iterator vrijednosti bez kopiranja elemenata. Svaki next() čita trenutačni indeks i ponovno provjerava length, pa promjene primatelja prije posjeta položaju mogu biti vidljive. Rezultat koraka sadrži value i done; nakon iscrpljenja iterator ostaje iscrpljen.

Rupe se ne preskaču: obično čitanje nepostojećeg indeksa daje undefined. Iterator je i sam iterabilan, a Array.prototype[Symbol.iterator] u početku pokazuje na istu funkciju kao values. Metoda ne mijenja i generička je za array-like vrijednosti.

Stvaranje zahtijeva primatelja koji nije null ni undefined, inače baca TypeError. Pretvorba length, indeksirani getteri i proxy zamke izvode se tijekom iteracije, pa njihove pogreške izlaze iz next(). API je standardiziran u ECMAScript 2015.

Primjeri

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

Izvori