...
Eroare TypeScript · Uniuni, tipuri literale și never

error TS2339: Property 'toUpperCase' does not exist on type 'string | number'.

Pe scurt

Variabila are un tip uniune (string | number), iar metoda există doar pe una dintre variante. Fă narrowing înainte: if (typeof x === "string") x.toUpperCase(); în ramura aceea TypeScript știe că e string.

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

Ce înseamnă

Pe o uniune poți folosi direct doar ce au în comun toate variantele. toUpperCase există pe string, dar nu pe number, așa că pe string | number nu e permisă. Mesajul are de obicei și o a doua linie, care îți spune exact varianta problematică: „Property 'toUpperCase' does not exist on type 'number'.”

Același lucru se întâmplă cu uniuni de obiecte: Card | Transfer unde doar Card are numar, sau cu uniuni de tablouri și texte. TypeScript nu ghicește care variantă e la rulare; îi arăți tu, prin narrowing: typeof pentru primitive, instanceof pentru clase, "camp" in obj sau un câmp discriminant (tip: "card") pentru obiecte.

După verificare, în blocul respectiv tipul e restrâns la varianta dovedită și poți folosi metodele ei.

De ce apare: cauzele frecvente

1Metodă de string pe string | number

Greșit
TypeScript
function eticheta(cod: string | number) {
  return cod.toUpperCase();
}
Corect
TypeScript
function eticheta(cod: string | number) {
  if (typeof cod === "string") return cod.toUpperCase();
  return cod.toString();
}

typeof separă cele două variante; fiecare ramură folosește metodele variantei ei.

2Câmp care există doar pe unul dintre obiecte

Greșit
TypeScript
interface Card { tip: "card"; ultimele4: string }
interface Cash { tip: "cash" }
function info(p: Card | Cash) {
  return p.ultimele4;
}
Corect
TypeScript
interface Card { tip: "card"; ultimele4: string }
interface Cash { tip: "cash" }
function info(p: Card | Cash) {
  return p.tip === "card" ? p.ultimele4 : "numerar";
}

Câmpul tip (discriminant) îi spune lui TypeScript care variantă e în fiecare ramură.

3Text sau listă

Greșit
TypeScript
function primul(x: string | string[]) {
  return x.toLowerCase();
}
Corect
TypeScript
function primul(x: string | string[]) {
  return Array.isArray(x) ? x[0].toLowerCase() : x.toLowerCase();
}

Array.isArray restrânge la string[]; pe cealaltă ramură rămâne string.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă eroarea TS2339: Property 'padStart' does not exist on type 'string | number'. Fă narrowing cu typeof și transformă numerele în text, ca programul să afișeze pe două linii ID: 000042 și ID: 00A7F3.

Codul care dă eroarea
TypeScript
function formateazaId(id: string | number): string {
  return id.padStart(6, "0");
}
console.log(`ID: ${formateazaId(42)}`);
console.log(`ID: ${formateazaId("A7F3")}`);
După reparație, programul afișează
ID: 000042
ID: 00A7F3
Indiciu

Transformă valoarea în string când e număr (String(id)), apoi apelează padStart.

Alte forme ale mesajului

  • error TS2339: Property 'ultimele4' does not exist on type 'Card | Cash'.

Cum o eviți pe viitor

  • Folosește uniuni doar când o valoare chiar poate avea mai multe forme, și tratează fiecare formă explicit.
  • Pentru obiecte, adaugă un câmp discriminant comun (tip: "card" | "cash") și folosește switch pe el.
  • Normalizează valorile la intrare (de exemplu transformă tot în string cu String(cod)) ca restul codului să lucreze cu un singur tip.

Întrebări frecvente

De ce cod.toString() merge fără verificare?

Pentru că toString există și pe string, și pe number. Pe o uniune poți folosi direct tot ce au în comun toate variantele.

Pot scrie (cod as string).toUpperCase()?

Compilează, dar dacă cod e număr, la rulare primești TypeError: cod.toUpperCase is not a function. Verificarea cu typeof e la fel de scurtă și chiar sigură.

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.