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

TypeError: WeakRef: invalid target

Pe scurt

new WeakRef(valoare) acceptă doar obiecte (și simboluri nedeclarate global), nu texte, numere sau undefined. O valoare primitivă nu poate fi „colectată”, deci nu are sens o referință slabă la ea. Ține primitivele într-un Map obișnuit sau învelește-le într-un obiect.

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

Ce înseamnă

Un WeakRef ține o referință slabă către un obiect: nu împiedică eliberarea lui din memorie, iar deref() întoarce obiectul sau undefined dacă a fost colectat. Mecanismul are sens doar pentru valori cu identitate proprie, adică obiecte (inclusiv tablouri și funcții) și simboluri create cu Symbol(). Valorile primitive (texte, numere, true, null, undefined) nu pot fi colectate ca obiecte separate, așa că new WeakRef("abc") aruncă WeakRef: invalid target.

Aceeași regulă se aplică la FinalizationRegistry.prototype.register (invalid target), la WeakMap și la WeakSet (Invalid value used as weak map key, Invalid value used in weak set).

Apare de obicei într-un cache: vrei să păstrezi slab rezultatele, dar unele rezultate sunt texte (HTML generat, un JSON serializat) sau undefined, când o căutare n-a găsit nimic. Gândește-te dacă ai nevoie de WeakRef: pentru texte și numere, un Map cu limită de dimensiune e soluția simplă.

De ce apare: cauzele frecvente

1Cache cu WeakRef pentru texte

Greșit
JavaScript
const cache = new Map();
cache.set("pagina", new WeakRef(html));
Corect
JavaScript
const cache = new Map();
cache.set("pagina", html);

Un text nu poate fi ținut slab. Îl păstrezi direct, iar cache-ul îl golești când crește prea mult.

2Rezultat lipsă ajuns în WeakRef

Greșit
JavaScript
const ref = new WeakRef(lista.find((x) => x.id === 9));
Corect
JavaScript
const gasit = lista.find((x) => x.id === 9);
const ref = gasit ? new WeakRef(gasit) : null;

find întoarce undefined când nu găsește nimic. Creezi referința doar pentru un obiect real.

3Înregistrare în FinalizationRegistry cu un ID

Greșit
JavaScript
registru.register(fisier.id, "închide fișierul");
Corect
JavaScript
registru.register(fisier, fisier.id);

Primul argument e obiectul urmărit; ID-ul îl dai ca valoare transmisă la curățare.

Repară tu

Repară eroarea, direct în pagină

Funcția memoreaza ține în cache referințe slabe la rezultate, dar un rezultat e text, iar new WeakRef aruncă TypeError: WeakRef: invalid target. Repară funcția ca obiectele să fie păstrate cu WeakRef, iar valorile primitive direct, iar citeste să le întoarcă pe amândouă corect.

Codul care dă eroarea
JavaScript
const cache = new Map();

function memoreaza(cheie, valoare) {
  cache.set(cheie, new WeakRef(valoare));
}

function citeste(cheie) {
  const intrare = cache.get(cheie);
  return intrare instanceof WeakRef ? intrare.deref() : intrare;
}

const profil = { nume: "Ana" };
memoreaza("profil", profil);
memoreaza("titlu", "Bun venit");
console.log(`${citeste("titlu")}, ${citeste("profil").nume}`);
După reparație, programul afișează
Bun venit, Ana
Indiciu

Verifică tipul valorii înainte de new WeakRef și păstrează primitivele ca atare.

Alte forme ale mesajului

  • TypeError: FinalizationRegistry.prototype.register: invalid target

Cum o eviți pe viitor

  • Folosește WeakRef doar pentru obiecte mari și cu identitate proprie (de exemplu elemente DOM, structuri de date mari).
  • Verifică typeof valoare === "object" && valoare !== null înainte de new WeakRef.
  • Pentru cache-uri de texte sau numere, folosește un Map cu limită de dimensiune.
  • Nu te baza pe momentul în care memoria e eliberată: deref() poate întoarce obiectul încă mult timp.

Întrebări frecvente

De ce un text nu poate fi ținut slab?

Textele și numerele sunt valori, nu obiecte cu identitate: două texte „abc” sunt identice și pot fi refolosite intern de motor. Nu există un moment clar în care „acel text” dispare.

Merge WeakRef cu simboluri?

Da, în motoarele recente, cu simboluri create cu Symbol(). Simbolurile globale create cu Symbol.for() nu sunt acceptate, pentru că nu pot fi colectate.

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.