Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Array.prototype.values: iterátor hodnôt

values vráti živý iterátor, ktorý číta postupné indexované hodnoty vrátane undefined vzniknutého z dier.

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

Syntax

array.values()

array.values() vytvorí iterátor hodnôt bez kopírovania prvkov. Každé next() prečíta aktuálny index a znovu overí length, takže zmeny prijímateľa vykonané pred návštevou pozície môžu byť viditeľné. Výsledok kroku obsahuje value a done; po vyčerpaní iterátor zostane vyčerpaný.

Diery sa nepreskakujú: bežné čítanie chýbajúceho indexu dá undefined. Iterátor je sám iterovateľný a Array.prototype[Symbol.iterator] spočiatku odkazuje na rovnakú funkciu ako values. Metóda nemení a je všeobecná pre array-like hodnoty.

Vytvorenie vyžaduje prijímateľa iného než null či undefined, inak vyvolá TypeError. Prevod length, indexované gettery a proxy trapy prebiehajú počas iterácie, takže ich chyby vystúpia z next(). API bolo štandardizované v ECMAScript 2015.

Príklady

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);

Výsledok

build false
undefined false
deploy false
true
test
release true

Zdroje