CKTIS / JavaScript
Set.prototype.keys() — un iteratore dei valori di un insieme
Set.prototype.keys() restituisce un nuovo iteratore sui valori di un insieme nell’ordine di inserimento. Non restituisce né indici né un array: in un Set, chiavi e valori indicano gli stessi elementi.
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.keys()set.keys() non richiede argomenti e restituisce un nuovo iteratore sui valori dell’insieme nell’ordine di inserimento. Un Set non ha chiavi o indici separati. Nella libreria standard non modificata, Set.prototype.keys e Set.prototype.values fanno riferimento alla stessa funzione; il nome keys garantisce coerenza con l’interfaccia Map.
L’iteratore non è un array. Una chiamata a next() lo fa avanzare di un elemento, mentre [...iterator] raccoglie in un array gli elementi rimanenti. Quando è esaurito, next() restituisce un risultato con done: true. Chiamare di nuovo set.keys() crea un iteratore indipendente.
L’iteratore non è un’istantanea: un elemento eliminato prima di essere visitato viene saltato, mentre un elemento aggiunto prima che l’iterazione termini può essere visitato. Chiamare il metodo con un valore this privo dei dati interni di Set genera un TypeError.
Nell’esempio, la ripetizione di "red" non crea un secondo elemento. La prima chiamata a next() recupera "red", quindi espandendo l’iteratore rimane solo "blue".
Esempi
const colors = new Set(["red", "blue", "red"]);
const iterator = colors.keys();
console.log(Set.prototype.keys === Set.prototype.values);
console.log(iterator.next().value);
console.log([...iterator].join(","));
console.log(iterator.next().done);Risultato
true red blue true
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.