CKTIS / JavaScript
Set.prototype.values() — iteratore dei valori di un insieme
Il metodo values() restituisce un nuovo iteratore sui valori di un Set nell’ordine di inserimento. Non crea un array né una copia dell’insieme; ogni lettura fa avanzare l’iteratore e le modifiche all’insieme possono influire sul percorso rimanente.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
set.values()Chiama Set.prototype.values() nella forma set.values(), senza argomenti. Restituisce un nuovo iteratore sui valori nell’ordine di inserimento, non un array. La chiamata in sé non modifica l’insieme. Aggiungere di nuovo un valore già presente non crea un duplicato e non ne cambia la posizione.
Il metodo next() dell’iteratore restituisce un oggetto con le proprietà value e done. Quando l’iteratore è esaurito, queste valgono rispettivamente undefined e true; le chiamate successive non riavviano il percorso. Per un nuovo percorso, occorre chiamare di nuovo set.values(). L’iteratore supporta for...of e [...iterator], che consuma gli elementi rimanenti.
L’iteratore non è un’istantanea: salta i valori eliminati prima di essere visitati e può visitare quelli aggiunti prima che il percorso termini. Eliminare un valore e aggiungerlo di nuovo lo colloca in fondo; può quindi essere visitato un’altra volta se la sua occorrenza precedente era già stata letta. Evita aggiunte incontrollate durante l’iterazione.
Per impostazione predefinita, Set.prototype.keys e Set.prototype[Symbol.iterator] fanno riferimento alla stessa funzione di Set.prototype.values. entries(), invece, restituisce coppie [value, value]. values() richiede un ricevitore con dati interni di Set; chiamarlo su un oggetto normale o un array genera un TypeError.
Esempi
const set = new Set(["a", "b", "a"]);
const iterator = set.values();
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...iterator]));
console.log(JSON.stringify(iterator.next()));
console.log(JSON.stringify([...set.values()]));Risultato
{"value":"a","done":false}
["b"]
{"done":true}
["a","b"]Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.