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