error TS2339: Property 'toUpperCase' does not exist on type 'string | number'.
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
function eticheta(cod: string | number) {
return cod.toUpperCase();
}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
interface Card { tip: "card"; ultimele4: string }
interface Cash { tip: "cash" }
function info(p: Card | Cash) {
return p.ultimele4;
}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ă
function primul(x: string | string[]) {
return x.toLowerCase();
}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ă 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.
function formateazaId(id: string | number): string {
return id.padStart(6, "0");
}
console.log(`ID: ${formateazaId(42)}`);
console.log(`ID: ${formateazaId("A7F3")}`);ID: 000042 ID: 00A7F3
Indiciu
Transformă valoarea în string când e număr (String(id)), apoi apelează padStart.
Reparația
function formateazaId(id: string | number): string {
const text = typeof id === "number" ? String(id) : id;
return text.padStart(6, "0");
}
console.log(`ID: ${formateazaId(42)}`);
console.log(`ID: ${formateazaId("A7F3")}`);De ce merge
padStart e o metodă de string; pe un number nu există, deci nu poate fi apelată direct pe uniunea string | number. Verificarea typeof id === "number" restrânge tipul pe fiecare ramură a expresiei: pe una îl transformi cu String(id), pe cealaltă îl lași cum e. Variabila text are astfel tipul string, iar padStart(6, "0") completează cu zerouri la stânga până la 6 caractere.
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șteswitchpe 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
error TS2339: Property 'nume' does not exist on type 'Produs'. Accesezi o proprietate pe care tipul obiectului nu o are: interfața Produs nu declară câmpul nume. Fie ai scris greșit numele câmpului, fie lipsește din interfață și trebuie adăugat acolo. error TS18046: 'e' is of type 'unknown'. Variabila are tipul unknown (des: eroarea din catch, rezultatul lui JSON.parse tipat ca unknown) și nu poți folosi nimic pe ea până nu verifici ce este. Fă narrowing, de exemplu if (e instanceof Error) console.log(e.message). error TS2322: Type '"crypto"' is not assignable to type 'never'. Ai o verificare exhaustivă (const x: never = valoare în default) și o variantă a uniunii nu e tratată în switch. Mesajul îți spune exact care: adaugă case-ul pentru "crypto". Dacă nu folosești intenționat never, tipul s-a restrâns la nimic din cauza unor verificări contradictorii. Î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.
