...
Eroare JavaScript · Colecții, iteratori și generatori (Map, Set, WeakMap)

TypeError: Invalid value used as weak map key

Pe scurt

WeakMap acceptă drept chei doar obiecte (și simboluri neînregistrate), nu texte, numere sau null. Ai pus probabil un ID sau un nume ca cheie. Folosește un Map obișnuit pentru chei simple, sau păstrează WeakMap și folosește obiectul însuși ca cheie.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

WeakMap (și WeakSet) țin referințe „slabe” la chei: când obiectul-cheie nu mai e folosit nicăieri altundeva, garbage collector-ul îl poate șterge, iar intrarea dispare singură. Asta are sens doar pentru valori care au o identitate și pot fi colectate: obiecte (inclusiv funcții, tablouri, elemente DOM) și, în motoarele recente, simboluri neînregistrate. Valorile primitive ("ana", 42, true) nu pot fi „colectate”, așa că set cu o astfel de cheie aruncă Invalid value used as weak map key. La WeakSet.add mesajul e Invalid value used in weak set.

get, has și delete nu aruncă pentru chei primitive: întorc pur și simplu undefined sau false.

Cauza obișnuită: ai ales WeakMap pentru un cache sau pentru date asociate, dar ai pus ca cheie utilizator.id în loc de obiectul utilizator. Decide ce vrei: chei simple (ID-uri, texte) înseamnă Map; date legate de viața unui obiect înseamnă WeakMap cu obiectul drept cheie.

De ce apare: cauzele frecvente

1ID în loc de obiect ca cheie

Greșit
JavaScript
const vizite = new WeakMap();
vizite.set(utilizator.id, 1);
Corect
JavaScript
const vizite = new Map();
vizite.set(utilizator.id, 1);

Pentru chei de tip ID sau text, Map e structura potrivită.

2Cheie null sau undefined

Greșit
JavaScript
const cache = new WeakMap();
cache.set(document.querySelector(".lipsa"), date);
Corect
JavaScript
const el = document.querySelector(".lipsa");
if (el) cache.set(el, date);

querySelector întoarce null dacă nu găsește elementul, iar null nu poate fi cheie.

3WeakSet cu valori simple

Greșit
JavaScript
const vazute = new WeakSet();
vazute.add("pagina-1");
Corect
JavaScript
const vazute = new Set();
vazute.add("pagina-1");

WeakSet ține doar obiecte; pentru texte folosește Set.

Repară tu

Repară eroarea, direct în pagină

Programul numără vizitele fiecărui utilizator după ID, într-un WeakMap, dar se oprește cu TypeError: Invalid value used as weak map key. Alege colecția potrivită pentru chei de tip text ca programul să afișeze u1: 2 vizite și u2: 1 vizite.

Codul care dă eroarea
JavaScript
const vizite = new WeakMap();

for (const id of ["u1", "u2", "u1"]) {
  vizite.set(id, (vizite.get(id) || 0) + 1);
}

for (const id of ["u1", "u2"]) {
  console.log(`${id}: ${vizite.get(id)} vizite`);
}
După reparație, programul afișează
u1: 2 vizite
u2: 1 vizite
Indiciu

Cheile sunt ID-uri (texte), iar WeakMap acceptă doar obiecte ca chei.

Alte forme ale mesajului

  • TypeError: Invalid value used in weak set

Cum o eviți pe viitor

  • Folosește Map și Set implicit; alege WeakMap / WeakSet doar când cheia e un obiect a cărui viață o urmărești.
  • Verifică dacă cheia nu e null înainte de set (mai ales cu elemente DOM).
  • Nu te baza pe WeakMap pentru numărare sau listare: nu are size și nu poate fi parcurs.
  • Numește variabila după tipul cheii: vizitePeId vs datePeElement.

Întrebări frecvente

Când are rost un WeakMap?

Când vrei să atașezi date unui obiect pe care nu-l controlezi (un element DOM, o instanță primită de la o bibliotecă) fără să împiedici ștergerea lui din memorie.

De ce nu pot parcurge un WeakMap?

Pentru că intrările pot dispărea oricând, când garbage collector-ul colectează cheile. Un for...of ar da rezultate imprevizibile, așa că limbajul nu îl permite.

Erori înrudite

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.