Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.values: iteratore dei valori

values restituisce un iteratore vivo che legge valori indicizzati successivi, incluso undefined prodotto dai vuoti.

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

Sintassi

array.values()

array.values() crea un iteratore dei valori senza copiare gli elementi. Ogni next() legge l’indice corrente e controlla nuovamente length, quindi può osservare modifiche del ricevente effettuate prima di visitare una posizione. Il risultato di un passo contiene value e done; una volta esaurito, l’iteratore resta esaurito.

I vuoti non sono saltati: la lettura normale di un indice assente produce undefined. L’iteratore è a sua volta iterabile e Array.prototype[Symbol.iterator] inizialmente indica la stessa funzione di values. Il metodo non muta ed è generico per valori array-like.

La creazione richiede un ricevente diverso da null e undefined, altrimenti genera TypeError. Conversione di length, getter indicizzati e trap di proxy avvengono durante l’iterazione, quindi i loro errori emergono da next(). L’API risale a ECMAScript 2015.

Esempi

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

Risultato

build false
undefined false
deploy false
true
test
release true

Fonti