Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes