...
Eroare Angular · Verificarea tipurilor în șabloane și TypeScript

TS2339: Property 'numeClient' does not exist on type 'App'.

Pe scurt

Șablonul (sau codul) folosește o proprietate care nu există în clasa componentei: nume scris greșit, câmp redenumit doar în clasă, sau citit dintr-un signal fără (). Folosește exact numele din clasă sau adaugă proprietatea.

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

Ce înseamnă

Cu strictTemplates (activat implicit în proiectele noi), Angular verifică șabloanele ca pe cod TypeScript. Fiecare nume din {{ }}, [binding] sau (eveniment) trebuie să existe în clasa componentei. Dacă nu, ng build și ng serve opresc compilarea cu TS2339: Property 'numeClient' does not exist on type 'App', cu fișierul și rândul din șablon.

Același cod apare și pentru proprietăți ale altor tipuri: Property 'nume' does not exist on type 'WritableSignal<Produs>' înseamnă că ai uitat să apelezi signal-ul (produs().nume), iar on type 'Produs' înseamnă că interfața nu are acel câmp.

Fără verificarea tipurilor (de exemplu în JIT), greșeala nu oprește nimic: expresia dă undefined, iar pe ecran apare un spațiu gol, o eroare mai greu de observat.

De ce apare: cauzele frecvente

1Nume diferit în șablon și în clasă

Greșit
TypeScript
<p>{{ numeClient }}</p>
// clasă:
nume = signal('Ana');
Corect
TypeScript
<p>{{ nume() }}</p>
// clasă:
nume = signal('Ana');

Șablonul vede doar membrii clasei, cu numele lor exact.

2Proprietate citită din signal, nu din valoare

Greșit
TypeScript
<h2>{{ produs.nume }}</h2>
Corect
TypeScript
<h2>{{ produs().nume }}</h2>

Mesajul spune does not exist on type 'WritableSignal<Produs>': obiectul e în produs().

3Câmp lipsă din interfață

Greșit
TypeScript
interface Produs { id: number; nume: string; }
// șablon:
{{ p.pret }}
Corect
TypeScript
interface Produs { id: number; nume: string; pret: number; }
// șablon:
{{ p.pret }}

Dacă datele chiar au câmpul, adaugă-l în tip; dacă nu, nu-l afișa.

Repară tu

Repară eroarea, direct în pagină

Componenta trebuie să afișeze în #salut „Bun venit, Ana Ionescu!”. Șablonul folosește numeClient, care nu există în clasă (la build: „TS2339: Property 'numeClient' does not exist on type 'App'”), iar aici salutul apare fără nume. Repară șablonul ca să citească signal-ul existent.

Codul care dă eroarea
TypeScript
import { Component, signal } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `<p id="salut">Bun venit, {{ numeClient }}!</p>`
})
export class App {
  nume = signal('Ana Ionescu');
}
Indiciu

Clasa are signal-ul nume, care se citește cu nume().

Alte forme ale mesajului

  • error TS2339: Property 'numeClient' does not exist on type 'App'.
  • TS2339: Property 'nume' does not exist on type 'WritableSignal<Produs>'.
  • TS2339: Property 'pret' does not exist on type 'Produs'.
  • TS2551: Property 'numeClent' does not exist on type 'App'. Did you mean 'numeClient'?

Cum o eviți pe viitor

  • Lasă strictTemplates: true în tsconfig.json: prinzi greșelile la build, nu pe ecran.
  • Folosește completarea automată din Angular Language Service când scrii în șablon.
  • Redenumește proprietățile cu F2 în editor, ca să se schimbe și în șablon.
  • Declară tipuri pentru date (interface Produs) în loc de any.

Întrebări frecvente

Proprietatea există, dar e private. De ce primesc altă eroare?

Un membru private nu e accesibil din șablon: primești TS2341 („Property 'x' is private and only accessible within class 'App'”). Folosește protected pentru ce e folosit doar în șablon.

De ce în browser nu am nicio eroare, doar un text gol?

Fără verificarea tipurilor, o proprietate inexistentă e undefined, iar interpolarea afișează undefined ca text gol. Doar compilatorul AOT îți spune că numele nu există.

Erori înrudite

← Toate erorile Angular

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ță Angular de la zero, cu exerciții la fiecare lecție

Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.