Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.values: iterátor hodnot

values vrátí živý iterátor, který čte postupné indexované hodnoty včetně undefined vzniklého z děr.

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

Syntaxe

array.values()

array.values() vytvoří iterátor hodnot bez kopírování prvků. Každé next() přečte aktuální index a znovu ověří length, takže změny příjemce provedené před návštěvou pozice mohou být vidět. Výsledek kroku obsahuje value a done; po vyčerpání iterátor zůstane vyčerpaný.

Díry se nepřeskakují: běžné čtení chybějícího indexu dá undefined. Iterátor je sám iterovatelný a Array.prototype[Symbol.iterator] zpočátku odkazuje na stejnou funkci jako values. Metoda nemutuje a je obecná pro array-like hodnoty.

Vytvoření vyžaduje příjemce jiného než null či undefined, jinak vyvolá TypeError. Převod length, indexované gettery a proxy trapy probíhají během iterace, takže jejich chyby vystoupí z next(). API bylo standardizováno v ECMAScript 2015.

Pří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ýsledek

build false
undefined false
deploy false
true
test
release true

Zdroje