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

error TS2322: Type 'null' is not assignable to type 'string'.

Pe scurt

În modul strict, null nu face parte din tipul string. Dacă variabila sau câmpul poate fi gol, scrie tipul ca string | null; dacă nu, dă-i o valoare reală (de exemplu "") în loc de null.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Cu strictNullChecks (parte din strict), null și undefined sunt tipuri separate: un string e mereu un text, niciodată null. Când atribui null unui loc tipat string, primești TS2322 cu mesajul ăsta. Forma Type 'undefined' is not assignable to type 'string' apare la fel pentru undefined.

E o eroare frecventă când vii din JavaScript sau din Java, unde orice obiect poate fi null, sau când inițializezi o variabilă „goală” cu null până o completezi. Mai apare la return null dintr-o funcție cu tip : string și la câmpuri de interfață setate cu null.

Decide ce înseamnă „gol” pentru valoarea ta. Dacă e o stare reală („încă nu a fost aleasă”), include-o în tip: string | null, iar codul care o folosește va fi obligat s-o verifice. Dacă de fapt mereu există o valoare, pune una reală.

De ce apare: cauzele frecvente

1Inițializare cu null

Greșit
TypeScript
let utilizatorCurent: string = null;
Corect
TypeScript
let utilizatorCurent: string | null = null;

Tipul include acum starea „niciun utilizator”; la folosire, TypeScript îți cere să verifici null.

2return null dintr-o funcție cu tip string

Greșit
TypeScript
function gaseste(id: number): string {
  if (id === 1) return "Ana";
  return null;
}
Corect
TypeScript
function gaseste(id: number): string | null {
  if (id === 1) return "Ana";
  return null;
}

Tipul de return trebuie să spună că funcția poate să nu găsească nimic.

3null folosit ca text gol

Greșit
TypeScript
interface Produs { nume: string; descriere: string }
const p: Produs = { nume: "Pix", descriere: null };
Corect
TypeScript
interface Produs { nume: string; descriere: string }
const p: Produs = { nume: "Pix", descriere: "" };

Dacă descrierea poate fi doar goală, "" e o valoare validă de tip string.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2322: Type 'null' is not assignable to type 'string'. Lista de așteptare poate fi goală, deci funcția poate întoarce null: corectează tipul de return, ca programul să afișeze pe două linii Următorul: Ana și Următorul: nimeni.

Codul care dă eroarea
TypeScript
function urmatorul(coada: string[]): string {
  if (coada.length === 0) {
    return null;
  }
  return coada[0];
}
console.log(`Următorul: ${urmatorul(["Ana", "Dan"]) ?? "nimeni"}`);
console.log(`Următorul: ${urmatorul([]) ?? "nimeni"}`);
După reparație, programul afișează
Următorul: Ana
Următorul: nimeni
Indiciu

Tipul de return trebuie să includă și null.

Alte forme ale mesajului

  • error TS2322: Type 'undefined' is not assignable to type 'string'.
  • error TS2322: Type 'null' is not assignable to type 'number'.

Cum o eviți pe viitor

  • Nu dezactiva strictNullChecks: e cea mai utilă verificare din TypeScript.
  • Scrie | null doar în tipurile care chiar pot fi goale și tratează cazul o singură dată, aproape de sursă.
  • Pentru câmpuri care pot lipsi complet, preferă câmpuri opționale (descriere?: string) în loc de null.

Întrebări frecvente

De ce merge în JavaScript, dar nu aici?

Pentru că JavaScript nu are tipuri statice. TypeScript în modul strict separă null de restul tipurilor, ca să nu primești la rulare „Cannot read properties of null”.

null sau undefined, ce aleg?

Ambele merg. Multe proiecte folosesc undefined pentru „lipsește” (câmpuri opționale) și null pentru „golit intenționat”. Important e să fii consecvent.

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.