error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'.
Trimiți unei funcții o valoare care poate fi undefined (câmp opțional, find(), Map.get()), dar parametrul acceptă doar string. Verifică valoarea înainte de apel, dă-i o valoare implicită cu ?? sau, dacă funcția poate trata lipsa, fă parametrul opțional.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul are de obicei și o a doua linie: „Type 'undefined' is not assignable to type 'string'”. Asta e partea importantă: argumentul are tipul uniune string | undefined, iar parametrul nu acceptă componenta undefined.
Apare când valoarea vine dintr-un câmp opțional (client.email cu email?: string), din find, Map.get, array[i] cu noUncheckedIndexedAccess, din process.env.X în Node sau dintr-o funcție a ta care întoarce | undefined. Pe același tipar vezi 'number | undefined', 'Produs | undefined' sau 'string | null'.
Decide unde se tratează lipsa: înainte de apel (o verificare if, o valoare implicită cu ??), sau în funcție (parametru nume?: string ori string | undefined, cu tratarea cazului în corp). Ce nu e o soluție bună: valoare! fără să știi sigur că există.
De ce apare: cauzele frecvente
1Câmp opțional trimis mai departe
interface Client { nume: string; email?: string }
function trimite(adresa: string) { return `trimis la ${adresa}`; }
const c: Client = { nume: "Ana" };
trimite(c.email);interface Client { nume: string; email?: string }
function trimite(adresa: string) { return `trimis la ${adresa}`; }
const c: Client = { nume: "Ana" };
if (c.email) trimite(c.email);În if, c.email e doar string. Clienții fără email sunt ocoliți.
2Valoare implicită înainte de apel
const setari = new Map<string, string>();
function aplicaTema(t: string) { return t; }
aplicaTema(setari.get("tema"));const setari = new Map<string, string>();
function aplicaTema(t: string) { return t; }
aplicaTema(setari.get("tema") ?? "light");?? "light" transformă string | undefined în string.
3Funcția poate trata singură lipsa
function eticheta(nume: string) { return nume.trim(); }
const x: string | undefined = undefined;
eticheta(x);function eticheta(nume?: string) { return nume?.trim() ?? "fără nume"; }
const x: string | undefined = undefined;
eticheta(x);Dacă lipsa e normală, parametrul opțional mută tratarea într-un singur loc.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string', pentru că orașul clientului e opțional. Dă-i o valoare implicită la apel, ca programul să afișeze pe două linii Ana Pop - CLUJ și Ion Rusu - NECUNOSCUT.
interface Client {
nume: string;
oras?: string;
}
function majuscule(text: string): string {
return text.toUpperCase();
}
const clienti: Client[] = [{ nume: "Ana Pop", oras: "Cluj" }, { nume: "Ion Rusu" }];
for (const client of clienti) {
console.log(`${client.nume} - ${majuscule(client.oras)}`);
}Ana Pop - CLUJ Ion Rusu - NECUNOSCUT
Indiciu
Folosește client.oras ?? "necunoscut" ca argument.
Reparația
interface Client {
nume: string;
oras?: string;
}
function majuscule(text: string): string {
return text.toUpperCase();
}
const clienti: Client[] = [{ nume: "Ana Pop", oras: "Cluj" }, { nume: "Ion Rusu" }];
for (const client of clienti) {
console.log(`${client.nume} - ${majuscule(client.oras ?? "necunoscut")}`);
}De ce merge
Un câmp opțional oras?: string are la citire tipul string | undefined, iar al doilea client chiar nu are oraș. Funcția majuscule cere un string sigur, pentru că apelează toUpperCase. Cu client.oras ?? "necunoscut", expresia devine string în orice caz: orașul real când există, textul de rezervă altfel. Funcția rămâne simplă și nu trebuie să știe nimic despre câmpuri lipsă.
Alte forme ale mesajului
error TS2345: Argument of type 'number | undefined' is not assignable to parameter of type 'number'.error TS2345: Argument of type 'string | null' is not assignable to parameter of type 'string'.
Cum o eviți pe viitor
- Tratează valorile opționale la marginea codului (când citești datele), ca restul funcțiilor să primească tipuri complete.
- Folosește
??pentru valori implicite șiifpentru cazurile în care operația nu are sens fără valoare. - Nu face parametrii opționali doar ca să scapi de eroare: mută problema în funcție, unde tot trebuie tratată.
Întrebări frecvente
Am verificat valoarea mai sus, de ce tot primesc eroarea?
Dacă verificarea e într-o funcție separată sau într-o altă iterație, TypeScript nu o leagă de apel. Narrowing-ul funcționează doar pe aceeași variabilă, în același bloc, și se pierde dacă între timp variabila poate fi modificată (de exemplu într-un callback).
E la fel cu 'string | null'?
Da, aceeași logică: Argument of type 'string | null' is not assignable to parameter of type 'string', reparat cu if (x !== null) sau x ?? "".
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 TS2345: Argument of type 'string' is not assignable to parameter of type 'number'. Ai apelat o funcție cu un argument de alt tip decât cel declarat la parametru: funcția așteaptă number și primește string. Convertește valoarea înainte de apel (Number(...)) sau verifică dacă ai pus argumentele în ordinea corectă. 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 ??. Î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.
