Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.values: iterador de valores

values devuelve un iterador vivo que lee valores indexados sucesivos, incluido undefined originado por huecos.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

array.values()

array.values() crea un iterador de valores sin copiar elementos. Cada next() lee el índice actual y vuelve a consultar length, por lo que puede observar cambios del receptor realizados antes de visitar una posición. Un resultado de paso contiene value y done; tras agotarse, el iterador sigue agotado.

Los huecos no se omiten: leer normalmente un índice ausente produce undefined. El iterador es a su vez iterable y Array.prototype[Symbol.iterator] apunta inicialmente a la misma función que values. El método no muta y es genérico para valores array-like.

La creación exige un receptor distinto de null y undefined; de lo contrario lanza TypeError. La conversión de length, getters indexados y traps de proxy ocurren durante la iteración, así que sus fallos salen de next(). La API se estandarizó en ECMAScript 2015.

Ejemplos

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

Fuentes