TypeError: Cannot read properties of undefined (reading 'subscribe')
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
toate(): Observable<Produs[]> {
this.http.get<Produs[]>('/api/produse');
}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
incarca = () => { this.http.get('/api/produse'); };incarca = () => this.http.get('/api/produse');Forma fără acolade întoarce automat expresia.
3Mock de test fără valoare întoarsă
const api = { toate: vi.fn() };const api = { toate: vi.fn().mockReturnValue(of([])) };vi.fn() întoarce undefined; componenta are nevoie de un Observable, de exemplu of([]).
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.
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.
Reparația
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[]> {
return 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));
}
}De ce merge
Metoda toate() creează cererea, dar nu o întoarce, așa că apelul this.api.toate() produce undefined. Componenta încearcă apoi undefined.subscribe(...) și JavaScript se oprește.
Cu return, componenta primește Observable-ul cererii. Abonarea pornește cererea HTTP, iar răspunsul ajunge în signal-ul produse, care actualizează lista. Mediul nostru nu verifică tipurile, dar ng build ar fi semnalat lipsa lui return.
Alte forme ale mesajului
ERROR TypeError: Cannot read properties of undefined (reading 'subscribe')TypeError: Cannot read property 'subscribe' of undefinedTypeError: this.api.toate(...) is undefined
Cum o eviți pe viitor
- Declară explicit tipul întors (
: Observable<Produs[]>): TypeScript te avertizează când lipseștereturn. - 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(...)sauthrowError(...).
Î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
TypeError: Cannot read properties of undefined (reading 'pipe') (interceptor care nu întoarce next(req)) Un interceptor HTTP apelează next(req) dar nu întoarce rezultatul, deci HttpClient primește undefined în loc de Observable și se oprește la .pipe. Scrie return next(req) (sau return next(req.clone(...))). HttpClient.post() nu trimite nicio cerere: Observable-ul nu are subscribe() Metodele HttpClient (get, post, put, delete) doar pregătesc cererea: ea pleacă abia când cineva se abonează. Fără subscribe() (sau async pipe, toSignal, firstValueFrom), în Network nu apare nimic și nu primești nicio eroare. Http failure during parsing for http://localhost:4200/api/raport Serverul a răspuns cu succes, dar corpul nu e JSON valid (text simplu, HTML, un fișier), iar HttpClient încearcă implicit să-l citească drept JSON. Cere tipul potrivit cu responseType: 'text' (sau 'blob') ori verifică adresa. Î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.
