error TS2722: Cannot invoke an object which is possibly 'undefined'.
Apelezi o funcție care poate lipsi (un callback opțional, o metodă opțională dintr-o interfață). Verifică întâi că există sau folosește apelul opțional: onGata?.(); ori dă-i o valoare implicită.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul înseamnă: expresia pe care o apelezi cu () are un tip care include undefined, deci la rulare s-ar putea să încerci să apelezi undefined, ceea ce ar da TypeError: onGata is not a function. Varianta TS2721 spune același lucru pentru null.
Apare aproape mereu la callback-uri opționale (onSucces?: () => void în props sau opțiuni), la metode opționale în interfețe (formateaza?(x: number): string), la funcții citite dintr-un obiect cu index (actiuni[nume]) sau din Map.get.
Ai trei reparații: apelul opțional f?.(), care nu face nimic dacă funcția lipsește; o verificare if (f) f(), utilă când ai și o ramură alternativă; sau o valoare implicită (onGata = () => {}) când funcția trebuie să existe mereu în corp.
De ce apare: cauzele frecvente
1Callback opțional apelat direct
function salveaza(onGata?: () => void) {
onGata();
}function salveaza(onGata?: () => void) {
onGata?.();
}?.() apelează funcția doar dacă există.
2Metodă opțională din interfață
interface Format { prefix?: () => string }
function f(o: Format) {
return o.prefix() + "1";
}interface Format { prefix?: () => string }
function f(o: Format) {
return (o.prefix?.() ?? "") + "1";
}Dacă metoda lipsește, ?? dă o valoare de rezervă.
3Funcție luată dintr-un Map
const actiuni = new Map<string, () => void>();
actiuni.get("start")();const actiuni = new Map<string, () => void>();
const start = actiuni.get("start");
if (start) start();Map.get întoarce undefined pentru chei lipsă, deci verifici întâi.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2722: Cannot invoke an object which is possibly 'undefined'. Callback-ul laFinal e opțional. Repară apelul ca programul să afișeze Comanda 1 salvată, Notificare trimisă și Comanda 2 salvată.
function salveaza(id: number, laFinal?: () => void): void {
console.log(`Comanda ${id} salvată`);
laFinal();
}
salveaza(1, () => console.log("Notificare trimisă"));
salveaza(2);Comanda 1 salvată Notificare trimisă Comanda 2 salvată
Indiciu
Folosește apelul opțional ?.() pentru laFinal.
Reparația
function salveaza(id: number, laFinal?: () => void): void {
console.log(`Comanda ${id} salvată`);
laFinal?.();
}
salveaza(1, () => console.log("Notificare trimisă"));
salveaza(2);De ce merge
Parametrul laFinal e opțional, deci tipul lui este (() => void) | undefined, iar la al doilea apel chiar lipsește. Apelul direct ar fi aruncat TypeError la rulare. laFinal?.() apelează funcția doar când a fost trimisă: la prima comandă se afișează notificarea, la a doua nu se întâmplă nimic în plus.
Alte forme ale mesajului
error TS2721: Cannot invoke an object which is possibly 'null'.error TS2723: Cannot invoke an object which is possibly 'null' or 'undefined'.
Cum o eviți pe viitor
- Pentru callback-uri opționale, folosește sistematic
callback?.(). - Dacă funcția trebuie să existe mereu, dă-i o valoare implicită în parametri (
= () => {}). - Pentru funcții luate din
Mapsau din obiecte după cheie, verifică rezultatul înainte de apel. - Marchează opționale doar callback-urile care chiar pot lipsi.
Întrebări frecvente
Care e diferența dintre f?.() și f!()?
f?.() verifică la rulare și nu apelează nimic dacă f lipsește. f!() doar îi spune compilatorului să nu se mai plângă; dacă f chiar e undefined, programul aruncă eroare.
De ce TS2722 și nu TS18048?
TS18048 ('x' is possibly 'undefined') apare când citești o proprietate. TS2722 e varianta pentru apelul unei funcții care poate lipsi. În versiunile noi poți vedea și TS18048 cu numele variabilei.
Erori înrudite
error TS18048: 'produs' is possibly 'undefined'. Variabila poate fi undefined (rezultat de la find(), Map.get(), un câmp opțional), iar tu o folosești ca și cum ar avea mereu valoare. Verifică înainte (if (produs)), folosește ?. și ?? pentru o valoare implicită, sau tratează explicit cazul lipsă. error TS2532: Object is possibly 'undefined'. O expresie fără nume (rezultatul unui apel, un element dintr-un lanț) poate fi undefined și tu accesezi ceva pe ea. Salvează rezultatul într-o variabilă și verifică-l, sau folosește ?. și ??. error TS2349: This expression is not callable. Pui paranteze () după ceva care nu e funcție: o proprietate (length), un getter, un număr sau o variabilă care ascunde o funcție cu același nume. Scoate parantezele sau apelează funcția corectă. Învață TypeScript de la zero, cu exerciții la fiecare lecție
Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
