CKTIS / JavaScript
Array.prototype.values: iterador de valores
values devolve um iterador vivo que lê valores indexados sucessivos, incluindo undefined proveniente de espaços vazios.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
array.values()array.values() cria um iterador de valores sem copiar elementos. Cada next() lê o índice atual e volta a verificar length, pelo que pode observar alterações ao recetor feitas antes de visitar uma posição. O resultado de um passo contém value e done; depois de esgotado, o iterador continua esgotado.
Os espaços vazios não são ignorados: a leitura normal de um índice ausente produz undefined. O iterador é também iterável e Array.prototype[Symbol.iterator] aponta inicialmente para a mesma função que values. O método não altera e é genérico para valores array-like.
A criação exige um recetor diferente de null e undefined, caso contrário lança TypeError. Conversão de length, getters indexados e traps de proxy ocorrem durante a iteração, por isso os seus erros saem de next(). A API foi normalizada no ECMAScript 2015.
Exemplos
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);Resultado
build false undefined false deploy false true test release true