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

TypeError: FinalizationRegistry: cleanup must be callable

Pe scurt

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ă

Greșit
JavaScript
const registru = new FinalizationRegistry(curataCache());
Corect
JavaScript
const registru = new FinalizationRegistry(curataCache);

Fără paranteze, constructorul primește funcția și o va apela el mai târziu.

2Argument lipsă

Greșit
JavaScript
const registru = new FinalizationRegistry();
Corect
JavaScript
const registru = new FinalizationRegistry((cheie) => cache.delete(cheie));

Funcția de curățare e obligatorie; ea primește valoarea dată la register.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Registru creat
Imagini în cache: 1
Indiciu

Transmite funcția stergeDinCache fără paranteze.

Alte forme ale mesajului

  • TypeError: FinalizationRegistry: cleanup must be callable at new FinalizationRegistry
  • TypeError: FinalizationRegistry: cleanup must be callable
  • TypeError: 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 FinalizationRegistry doar ca ajutor suplimentar: eliberează resursele explicit (close(), dispose()).
  • Pentru cache-uri care nu țin obiectele în viață, combină WeakRef cu 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

← 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.