TypeError: FinalizationRegistry: cleanup must be callable
new FinalizationRegistry(...) a primit altceva decât o funcție, de obicei rezultatul apelării ei (curata()) în loc de funcția însăși (curata), sau nimic. Dă-i funcția care va fi apelată când obiectul e eliberat: new FinalizationRegistry(curata).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
FinalizationRegistry îți permite să rulezi o funcție de curățare după ce un obiect a fost eliberat de garbage collector (de exemplu, să închizi o resursă asociată sau să ștergi o intrare dintr-un cache). Constructorul primește o funcție: new FinalizationRegistry((valoare) => {...}). Dacă primește undefined, un obiect sau rezultatul unei funcții, aruncă imediat FinalizationRegistry: cleanup must be callable.
Cea mai frecventă greșeală e să scrii new FinalizationRegistry(curata()): parantezele apelează funcția pe loc, iar constructorul primește ce a întors ea (undefined). A doua e să uiți argumentul complet.
Reține și limitele: momentul în care rulează curățarea nu e garantat (poate fi mult mai târziu sau deloc, dacă programul se termină). Folosește-l doar ca plasă de siguranță, nu pentru logică obligatorie.
De ce apare: cauzele frecvente
1Funcția apelată în loc să fie transmisă
const registru = new FinalizationRegistry(curataCache());const registru = new FinalizationRegistry(curataCache);Fără paranteze, constructorul primește funcția și o va apela el mai târziu.
2Argument lipsă
const registru = new FinalizationRegistry();const registru = new FinalizationRegistry((cheie) => cache.delete(cheie));Funcția de curățare e obligatorie; ea primește valoarea dată la register.
Repară eroarea, direct în pagină
Cache-ul de imagini creează un FinalizationRegistry care să șteargă intrările eliberate, dar codul dă TypeError: FinalizationRegistry: cleanup must be callable. Repară crearea registrului ca programul să afișeze Registru creat și Imagini în cache: 1.
const cache = new Map();
function stergeDinCache(cheie) {
cache.delete(cheie);
}
const registru = new FinalizationRegistry(stergeDinCache());
console.log("Registru creat");
const imagine = { url: "/logo.png" };
cache.set("logo", new WeakRef(imagine));
registru.register(imagine, "logo");
console.log(`Imagini în cache: ${cache.size}`);Registru creat Imagini în cache: 1
Indiciu
Transmite funcția stergeDinCache fără paranteze.
Reparația
const cache = new Map();
function stergeDinCache(cheie) {
cache.delete(cheie);
}
const registru = new FinalizationRegistry(stergeDinCache);
console.log("Registru creat");
const imagine = { url: "/logo.png" };
cache.set("logo", new WeakRef(imagine));
registru.register(imagine, "logo");
console.log(`Imagini în cache: ${cache.size}`);De ce merge
stergeDinCache() cu paranteze rulează funcția imediat și dă constructorului rezultatul ei, undefined. Fără paranteze, registrul primește funcția și o păstrează, ca să o apeleze cu cheia "logo" după ce obiectul imagine e eliberat. Până atunci, cache-ul are o intrare. Momentul curățării nu e garantat, deci programul nu se bazează pe el.
Alte forme ale mesajului
TypeError: FinalizationRegistry: cleanup must be callable at new FinalizationRegistryTypeError: FinalizationRegistry: cleanup must be callableTypeError: FinalizationRegistry constructor argument must be callable
Cum o eviți pe viitor
- Când dai o funcție ca argument (callback), scrie-i doar numele, fără paranteze.
- Folosește
FinalizationRegistrydoar ca ajutor suplimentar: eliberează resursele explicit (close(),dispose()). - Pentru cache-uri care nu țin obiectele în viață, combină
WeakRefcu registrul și testează că aplicația merge corect chiar dacă curățarea nu rulează.
Întrebări frecvente
Când rulează funcția de curățare?
Cândva după ce obiectul a fost colectat, la alegerea motorului. Nu se poate forța și nu e garantat că rulează înainte de închiderea programului.
E la fel cu WeakRef: invalid target?
Sunt din aceeași familie, dar acea eroare apare când dai lui WeakRef sau lui register o valoare care nu poate fi ținută slab, de exemplu un număr.
Erori înrudite
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. 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: calculeazaTotal is not a function Apelezi cu `()` ceva care nu este o funcție: un număr, un text, un obiect sau `undefined`. De obicei numele metodei e scris greșit, ai suprascris funcția cu o variabilă cu același nume sau metoda nu există pe acel tip de valoare. Verifică ce conține de fapt numele din mesaj. Î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.
