Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

WeakMap.get() — leggere un valore tramite la chiave

`weakMap.get(key)` restituisce il valore associato a una chiave. Usa `has(key)` per distinguere una voce assente da una che contiene `undefined`.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

weakMap.get(key)

WeakMap.get è il nome abbreviato del metodo di istanza WeakMap.prototype.get, non di un metodo statico del costruttore. weakMap.get(key) legge il valore memorizzato senza modificare la mappa. Le chiavi si confrontano per identità: due oggetti creati separatamente con le stesse proprietà sono chiavi diverse. Se il valore memorizzato è un oggetto, get() restituisce lo stesso oggetto, non una copia.

Sia una voce assente sia una voce che contiene undefined danno come risultato undefined. Usa weakMap.has(key) per distinguerle: restituisce true se la voce esiste, anche se il suo valore è undefined.

ECMAScript 2024 ammette come chiavi gli oggetti, comprese le funzioni, e i simboli non registrati come Symbol('id'). I motori meno recenti possono supportare WeakMap ma non i simboli come chiavi. Su un’istanza di WeakMap, get() restituisce undefined per una chiave non valida, per esempio una stringa o un simbolo restituito da Symbol.for(), mentre set() genera un TypeError. Anche get() genera un TypeError se il suo this non è un’istanza di WeakMap, per esempio se chiami il metodo separatamente senza associarlo a un’istanza.

La mappa da sola non mantiene in vita una chiave. Quando la chiave non è più raggiungibile, la relativa voce può essere rimossa durante la garbage collection. Non puoi enumerare le chiavi né contare sul fatto che una voce venga rimossa in un momento preciso.

Esempi

const weakMap = new WeakMap();
const key = { id: 1 };
const otherKey = { id: 1 };

weakMap.set(key, 42);
console.log(String(weakMap.get(key)));
console.log(String(weakMap.get(otherKey)));

weakMap.set(otherKey, undefined);
console.log(String(weakMap.get(otherKey)));
console.log(String(weakMap.has(otherKey)));
console.log(String(weakMap.get('id')));

Risultato

42
undefined
undefined
true
undefined

`key` e `otherKey` sono oggetti distinti, pur avendo le stesse proprietà. Entrambe le letture di `otherKey` restituiscono `undefined`: prima la voce manca, poi esiste con il valore `undefined`, come conferma `has()`. L’ultima lettura usa una chiave non valida.

Lezioni correlate

  • JavaScript · Lezione 18 · Base · Versione: 4

Fonti