TypeError: Cannot read properties of undefined (reading 'toUpperCase')
Un pipe propriu apelează o metodă de text (toUpperCase, trim, split) pe o valoare care e încă undefined sau null, de exemplu înainte să sosească datele. Tratează valorile lipsă la începutul lui transform (if (!valoare) return '';).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În transform(valoare), un pipe propriu primește exact ce e în stânga lui |. Dacă acolo e o proprietate care încă nu are valoare (date care vin de la server, un câmp opțional, o greșeală de nume), valoare este undefined sau null, iar valoare.toUpperCase() aruncă TypeError: Cannot read properties of undefined (reading 'toUpperCase').
Stiva de apeluri arată metoda transform a pipe-ului tău; numele din ghilimele e metoda apelată (toUpperCase, trim, split, replace). Pipe-urile din Angular (uppercase, date, currency) tratează singure null/undefined și afișează gol; pipe-urile proprii trebuie să facă la fel.
Reparația standard: prima linie din transform verifică valoarea (if (valoare == null) return '';) și declari tipul ca string | null | undefined. Dacă valoarea lipsește din cauza unui nume greșit în șablon, corectează și numele.
De ce apare: cauzele frecvente
1transform fără verificarea valorii
transform(cod: string) {
return cod.toUpperCase().replace(/(.{4})/g, '$1 ').trim();
}transform(cod: string | null | undefined) {
if (!cod) return '';
return cod.toUpperCase().replace(/(.{4})/g, '$1 ').trim();
}Valorile lipsă întorc un text gol, ca la pipe-urile din Angular, iar restul codului rulează doar pe texte.
2Proprietate scrisă greșit în șablon
{{ client.Iban | iban }}{{ client.iban | iban }}O proprietate inexistentă e undefined, iar pipe-ul primește undefined.
Repară eroarea, direct în pagină
Pipe-ul propriu cod afișează codul de reducere cu majuscule, dar al doilea client nu are cod (undefined), iar aplicația se oprește cu „Cannot read properties of undefined (reading 'toUpperCase')”. Fă ca pipe-ul să întoarcă „fără cod” pentru valori lipsă, ca a doua linie .cod să afișeze „fără cod”, iar prima „VARA20”.
import { Component, Pipe, PipeTransform } from '@angular/core';
@Pipe({ name: 'cod' })
export class CodPipe implements PipeTransform {
transform(valoare: string) {
return valoare.toUpperCase();
}
}
@Component({
selector: 'app-root',
imports: [CodPipe],
template: `
@for (c of clienti; track c.nume) {
<p class="cod">{{ c.cod | cod }}</p>
}
`
})
export class App {
clienti: { nume: string; cod?: string }[] = [
{ nume: 'Ana', cod: 'vara20' },
{ nume: 'Mihai' }
];
}Indiciu
Verifică valoarea la începutul lui transform, înainte să apelezi metode de text.
Reparația
import { Component, Pipe, PipeTransform } from '@angular/core';
@Pipe({ name: 'cod' })
export class CodPipe implements PipeTransform {
transform(valoare: string | null | undefined) {
if (!valoare) return 'fără cod';
return valoare.toUpperCase();
}
}
@Component({
selector: 'app-root',
imports: [CodPipe],
template: `
@for (c of clienti; track c.nume) {
<p class="cod">{{ c.cod | cod }}</p>
}
`
})
export class App {
clienti: { nume: string; cod?: string }[] = [
{ nume: 'Ana', cod: 'vara20' },
{ nume: 'Mihai' }
];
}De ce merge
Pentru Mihai, c.cod este undefined, iar pipe-ul apela undefined.toUpperCase(), de unde TypeError în metoda transform.
Verificarea de la început (if (!valoare) return 'fără cod';) tratează valorile lipsă înainte de orice metodă de text. Pentru Ana pipe-ul întoarce „VARA20”, pentru Mihai „fără cod”. Tipul string | null | undefined face cazul vizibil și pentru TypeScript.
Alte forme ale mesajului
TypeError: Cannot read properties of null (reading 'toUpperCase')TypeError: Cannot read properties of undefined (reading 'trim')
Cum o eviți pe viitor
- Începe orice pipe propriu cu tratarea lui
null/undefined. - Declară tipul parametrului ca
string | null | undefined, ca TypeScript să-ți ceară verificarea. - Testează pipe-ul și cu valori lipsă, nu doar cu exemple complete.
- Fă pipe-urile pure și simple: doar transformă valoarea primită, fără să depindă de alte stări.
Întrebări frecvente
De ce pipe-urile Angular nu dau eroarea asta?
Pentru că fiecare începe cu o verificare: dacă valoarea e null sau undefined, întoarce null, iar șablonul afișează gol. E convenția pe care o urmezi și în pipe-urile tale.
Pot folosi ?. în șablon în loc de verificarea din pipe?
{{ client?.iban | iban }} evită eroarea când client lipsește, dar pipe-ul tot primește undefined. Verificarea trebuie făcută în transform.
Erori înrudite
error NG8004: No pipe found with name 'lei'. La compilare, Angular nu găsește un pipe cu numele folosit în șablon: pipe-ul tău nu e importat în componentă sau name din @Pipe diferă de ce ai scris. Adaugă clasa pipe-ului în imports: [...] și verifică numele. NG02100: InvalidPipeArgument: '5' for pipe 'UpperCasePipe' Pipe-urile uppercase, lowercase și titlecase acceptă doar texte (string). Ai trimis un număr, un obiect sau un boolean. Transformă valoarea în text (String(x) sau un template literal) sau aplică pipe-ul doar pe partea de text. NG02100: InvalidPipeArgument: '40712345678' for pipe 'SlicePipe' Pipe-ul slice merge doar pe texte și liste (array). Ai trimis un număr sau un obiect. Păstrează valoarea ca text (de exemplu un telefon sau un cod) sau transform-o cu String() înainte de slice. Î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.
