Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Map.prototype.values: iteratore di valori

Il metodo values restituisce un iteratore vivo dei valori Map nell’ordine di inserimento delle chiavi corrispondenti.

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

Sintassi

map.values()

map.values() crea un nuovo iteratore Map. Ogni next() riuscito restituisce il valore della voce successiva. Gli oggetti restano gli stessi riferimenti e valori uguali sotto chiavi diverse sono restituiti separatamente; nessuna deduplicazione.

L’iteratore è pigro, non un’istantanea. Salta voci eliminate prima della visita, un aggiornamento precedente dà il nuovo valore e un’aggiunta prima della fine può apparire. Aggiornare una chiave già visitata non la ripete. Dopo done: true, aggiunte successive non lo riattivano.

Il metodo non accetta argomenti significativi e richiede dati interni Map; oggetto, Set o Proxy non gestito genera TypeError. Standard da ECMAScript 2015. Per mantenere l’associazione con le chiavi, usare entries().

Esempi

const shared = {};
const map = new Map([["a", shared], ["b", 2], ["c", 2]]);
const values = map.values();
console.log(values.next().value === shared);
map.set("b", 20);
map.delete("c");
map.set("d", 4);
console.log(values.next().value);
console.log(values.next().value);
console.log(values.next().done);
map.set("e", 5);
console.log(values.next().done);
console.log([...new Map([["x", 1], ["y", 1]]).values()].join(","));
try { Map.prototype.values.call({}); } catch (error) { console.log(error instanceof TypeError); }

Risultato

true
20
4
true
true
1,1
true

Fonti