CKTIS / JavaScript
Map — una raccolta di coppie chiave-valore
Map memorizza chiavi univoche di qualsiasi tipo insieme ai valori associati. Consente di leggere ed eliminare voci, verificare la presenza di una chiave e iterare nell’ordine di inserimento.
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
new Map()
new Map(iterable)
map.set(key, value)
map.get(key)
map.has(key)
map.delete(key)
map.clear()
map.size
for (const [key, value] of map) { /* ... */ }Map è una raccolta integrata di coppie chiave-valore. Sia le chiavi sia i valori possono essere qualsiasi valore JavaScript. Crea una mappa vuota con new Map() oppure passa al costruttore un oggetto iterabile contenente coppie [key, value]. Chiamarlo senza new genera un TypeError.
set(key, value) aggiunge o aggiorna una voce e restituisce la mappa. get(key) ne legge il valore; se la chiave manca, restituisce undefined. Poiché anche un valore memorizzato può essere undefined, verifica la presenza con has(key). La proprietà size indica il numero di voci, delete(key) restituisce se una voce è stata eliminata e clear() rimuove tutte le voci.
Il confronto delle chiavi segue SameValueZero: NaN corrisponde a NaN e +0 e -0 sono la stessa chiave. Gli oggetti vengono confrontati per identità, non per contenuto. Due oggetti { id: 1 } creati separatamente sono quindi chiavi diverse.
L’iterazione con for...of produce coppie nell’ordine di inserimento delle chiavi; keys(), values() ed entries() restituiscono gli iteratori corrispondenti. Aggiornare un valore non sposta la sua voce, mentre eliminarla e reinserirla la sposta alla fine. Per aggiungere voci, usa set(key, value), non map[key] = value. L’assegnazione con parentesi quadre riguarda una proprietà dell’oggetto, non una voce della mappa. Per esempio, su un’istanza di Map non modificata, l’assegnazione map["size"] = value genera un TypeError in modalità rigorosa e viene ignorata altrimenti, perché la proprietà ereditata size ha un getter ma non un setter.
Esempi
const key = { id: 1 };
const map = new Map([["first", 1], [key, 2]]);
map.set("first", 3);
map.set(NaN, 4);
map.set(NaN, 5);
console.log(map.size);
console.log(map.get(key));
console.log(map.has({ id: 1 }));
console.log(map.get(NaN));
console.log(JSON.stringify([...map.values()]));Risultato
3 2 false 5 [3,2,5]
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.