...
Eroare Angular · Pipes

TypeError: Cannot read properties of undefined (reading 'toUpperCase')

Pe scurt

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

Greșit
TypeScript
transform(cod: string) {
  return cod.toUpperCase().replace(/(.{4})/g, '$1 ').trim();
}
Corect
TypeScript
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

Greșit
TypeScript
{{ client.Iban | iban }}
Corect
TypeScript
{{ client.iban | iban }}

O proprietate inexistentă e undefined, iar pipe-ul primește undefined.

Repară tu

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”.

Codul care dă eroarea
TypeScript
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.

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

← 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.