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

error TS2345: Argument of type 'string | undefined' is not assignable to parameter of type 'string'.

Pe scurt

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

Greșit
TypeScript
interface Client { nume: string; email?: string }
function trimite(adresa: string) { return `trimis la ${adresa}`; }
const c: Client = { nume: "Ana" };
trimite(c.email);
Corect
TypeScript
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

Greșit
TypeScript
const setari = new Map<string, string>();
function aplicaTema(t: string) { return t; }
aplicaTema(setari.get("tema"));
Corect
TypeScript
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

Greșit
TypeScript
function eticheta(nume: string) { return nume.trim(); }
const x: string | undefined = undefined;
eticheta(x);
Corect
TypeScript
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ă tu

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.

Codul care dă eroarea
TypeScript
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)}`);
}
După reparație, programul afișează
Ana Pop - CLUJ
Ion Rusu - NECUNOSCUT
Indiciu

Folosește client.oras ?? "necunoscut" ca argument.

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 și if pentru 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

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