TypeError: WeakRef: invalid target
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
const cache = new Map();
cache.set("pagina", new WeakRef(html));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
const ref = new WeakRef(lista.find((x) => x.id === 9));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
registru.register(fisier.id, "închide fișierul");registru.register(fisier, fisier.id);Primul argument e obiectul urmărit; ID-ul îl dai ca valoare transmisă la curățare.
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.
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}`);Bun venit, Ana
Indiciu
Verifică tipul valorii înainte de new WeakRef și păstrează primitivele ca atare.
Reparația
const cache = new Map();
function memoreaza(cheie, valoare) {
const esteObiect = typeof valoare === "object" && valoare !== null;
cache.set(cheie, esteObiect ? new WeakRef(valoare) : 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}`);De ce merge
WeakRef acceptă doar valori care pot fi colectate separat, adică obiecte. Textul „Bun venit” e o valoare primitivă, deci constructorul îl refuză. Acum memoreaza verifică tipul și creează referință slabă doar pentru obiecte, iar textul îl păstrează direct. citeste folosește deref() pentru referințele slabe și întoarce restul valorilor neschimbate.
Alte forme ale mesajului
TypeError: FinalizationRegistry.prototype.register: invalid target
Cum o eviți pe viitor
- Folosește
WeakRefdoar pentru obiecte mari și cu identitate proprie (de exemplu elemente DOM, structuri de date mari). - Verifică
typeof valoare === "object" && valoare !== nullînainte denew WeakRef. - Pentru cache-uri de texte sau numere, folosește un
Mapcu 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
TypeError: Invalid value used as weak map key 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. TypeError: Cannot create proxy with a non-object as target or handler new Proxy(tinta, handler) cere ca ambele argumente să fie obiecte. Unul dintre ele e un număr, un text, false, null sau undefined. Verifică ce trimiți: de obicei handler-ul e construit condiționat și devine false, sau ținta e o valoare primitivă în loc de obiect. TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. Î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.
