...
Eroare TypeScript · null, undefined și unknown

error TS2722: Cannot invoke an object which is possibly 'undefined'.

Pe scurt

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

Greșit
TypeScript
function salveaza(onGata?: () => void) {
  onGata();
}
Corect
TypeScript
function salveaza(onGata?: () => void) {
  onGata?.();
}

?.() apelează funcția doar dacă există.

2Metodă opțională din interfață

Greșit
TypeScript
interface Format { prefix?: () => string }
function f(o: Format) {
  return o.prefix() + "1";
}
Corect
TypeScript
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

Greșit
TypeScript
const actiuni = new Map<string, () => void>();
actiuni.get("start")();
Corect
TypeScript
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ă tu

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

Codul care dă eroarea
TypeScript
function salveaza(id: number, laFinal?: () => void): void {
  console.log(`Comanda ${id} salvată`);
  laFinal();
}
salveaza(1, () => console.log("Notificare trimisă"));
salveaza(2);
După reparație, programul afișează
Comanda 1 salvată
Notificare trimisă
Comanda 2 salvată
Indiciu

Folosește apelul opțional ?.() pentru laFinal.

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 Map sau 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

← Toate erorile TypeScript

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ță 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.