...
Eroare Angular · HttpClient și cereri HTTP

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

Pe scurt

Apelezi .subscribe() pe ceva care e undefined: de obicei o metodă de serviciu care face cererea, dar uită return, sau o proprietate Observable care nu a fost inițializată. Întoarce Observable-ul din metodă (return this.http.get(...)).

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

Ce înseamnă

Mesajul vine de la JavaScript: ai scris x.subscribe(...), iar x era undefined. În aplicațiile Angular, x este aproape mereu rezultatul unei metode de serviciu care ar trebui să întoarcă un Observable.

Cazul clasic: metoda are acolade și apelează this.http.get(...), dar fără return. O funcție fără return întoarce undefined, deci componenta primește nimic și se oprește la .subscribe. Cu o funcție săgeată cu acolade (() => { this.http.get(...) }) se întâmplă la fel.

Alte surse: un câmp produse$ declarat dar neinițializat, un @Input care încă nu are valoare, sau un mock de test (vi.fn()) care nu întoarce un Observable. Linia din stiva de apeluri arată componenta; urmărește de acolo metoda apelată.

De ce apare: cauzele frecvente

1Metoda serviciului nu are return

Greșit
TypeScript
toate(): Observable<Produs[]> {
  this.http.get<Produs[]>('/api/produse');
}
Corect
TypeScript
toate(): Observable<Produs[]> {
  return this.http.get<Produs[]>('/api/produse');
}

Cu return, apelantul primește Observable-ul și se poate abona. Cu verificarea tipurilor, TypeScript semnalează și „A function whose declared type is neither 'undefined', 'void', nor 'any' must return a value”.

2Funcție săgeată cu acolade

Greșit
TypeScript
incarca = () => { this.http.get('/api/produse'); };
Corect
TypeScript
incarca = () => this.http.get('/api/produse');

Forma fără acolade întoarce automat expresia.

3Mock de test fără valoare întoarsă

Greșit
TypeScript
const api = { toate: vi.fn() };
Corect
TypeScript
const api = { toate: vi.fn().mockReturnValue(of([])) };

vi.fn() întoarce undefined; componenta are nevoie de un Observable, de exemplu of([]).

Repară tu

Repară eroarea, direct în pagină

Serviciul ProduseApi are metoda toate(), dar componenta se oprește cu „Cannot read properties of undefined (reading 'subscribe')”. Repară metoda ca lista ul#produse să afișeze cele 3 produse de la /api/produse.

Codul care dă eroarea
TypeScript
import { Component, Injectable, inject, signal } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';

interface Produs { id: number; nume: string; }

@Injectable({ providedIn: 'root' })
export class ProduseApi {
  private http = inject(HttpClient);

  toate(): Observable<Produs[]> {
    this.http.get<Produs[]>('/api/produse');
  }
}

@Component({
  selector: 'app-root',
  template: `
    <ul id="produse">
      @for (p of produse(); track p.id) { <li>{{ p.nume }}</li> }
    </ul>
  `
})
export class App {
  private api = inject(ProduseApi);
  produse = signal<Produs[]>([]);

  constructor() {
    this.api.toate().subscribe((l) => this.produse.set(l));
  }
}
Indiciu

O metodă cu acolade întoarce undefined dacă nu are return.

Alte forme ale mesajului

  • ERROR TypeError: Cannot read properties of undefined (reading 'subscribe')
  • TypeError: Cannot read property 'subscribe' of undefined
  • TypeError: this.api.toate(...) is undefined

Cum o eviți pe viitor

  • Declară explicit tipul întors (: Observable<Produs[]>): TypeScript te avertizează când lipsește return.
  • Preferă metode scurte, care întorc direct cererea, și lasă componentele să decidă ce fac cu ea.
  • În teste, fă ca mock-urile să întoarcă of(...) sau throwError(...).

Întrebări frecvente

De ce nu a apărut eroarea la compilare?

Dacă metoda nu are tip declarat, TypeScript deduce void și nu se plânge; dacă are : any, la fel. Cu tipul Observable<Produs[]> declarat, compilatorul ar fi refuzat metoda fără return.

E la fel cu reading 'pipe'?

Aceeași cauză (o valoare undefined în loc de Observable), doar că primul apel făcut pe ea a fost .pipe(...). Caută funcția care trebuia să întoarcă Observable-ul.

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.