Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Map.prototype.get: leggere un valore per chiave

Il metodo get restituisce il valore memorizzato sotto una chiave Map corrispondente, oppure undefined se la voce non esiste.

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

Sintassi

map.get(key)

map.get(key) cerca la chiave senza conversione di tipo e non modifica la Map né l’ordine. Se trova la chiave restituisce esattamente il valore memorizzato, incluso lo stesso riferimento all’oggetto; altrimenti undefined.

Le chiavi usano SameValueZero: NaN corrisponde a NaN e -0 a +0; gli oggetti solo per identità. Poiché una voce può contenere intenzionalmente undefined, il risultato di get non la distingue dall’assenza: usare map.has(key).

Il ricevitore deve avere dati interni Map; oggetto, Set o Proxy non gestito come this genera TypeError. Standard da ECMAScript 2015. get non esegue fabbriche né crea voci; get-or-create deve usare esplicitamente has/set e considerare undefined.

Esempi

const key = { id: 7 };
const stored = { enabled: true };
const map = new Map([[key, stored], ["empty", undefined], [NaN, "not a number"]]);
console.log(map.get(key) === stored);
console.log(map.get({ id: 7 }));
console.log(map.get(NaN));
console.log(map.get("empty"), map.has("empty"));
console.log(map.get("missing"), map.has("missing"));

try {
  Map.prototype.get.call({}, "x");
} catch (error) {
  console.log(error instanceof TypeError);
}

Risultato

true
undefined
not a number
undefined true
undefined false
true

Fonti