TimeoutError: Timeout has occurred
Operatorul timeout() nu a primit nicio valoare în timpul stabilit și a transformat așteptarea în eroare. Tratează eroarea cu catchError (mesaj, valoare de rezervă, retry) sau mărește limita dacă serverul are nevoie de mai mult timp.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
timeout(ms) pune un ceas pe flux: dacă nu sosește nicio valoare în ms milisecunde, abonamentul la sursă e oprit și fluxul se termină cu TimeoutError: Timeout has occurred. E exact comportamentul dorit (nu lași utilizatorul să aștepte la nesfârșit), dar eroarea trebuie tratată ca orice altă eroare.
Dacă nu e tratată, ajunge în consolă ca eroare netratată, iar ce aștepta valoarea (un indicator „Se încarcă...”, un buton dezactivat) rămâne blocat. Când apare mereu, nu doar uneori, limita e prea mică pentru operația respectivă (un raport greu, un upload) sau serverul are o problemă reală.
Pentru cereri HTTP, HttpClient nu are o limită implicită de timp; timeout este felul obișnuit în care o adaugi, pe o cerere sau într-un interceptor.
De ce apare: cauzele frecvente
1timeout fără tratarea erorii
this.http.get('/api/raport').pipe(timeout(5000))
.subscribe((r) => this.raport.set(r));this.http.get('/api/raport').pipe(
timeout(5000),
catchError(() => {
this.eroare.set('Serverul răspunde greu.');
return of(null);
})
).subscribe((r) => this.raport.set(r));catchError transformă expirarea într-un mesaj și o valoare de rezervă.
2Limită prea mică pentru operație
this.http.post('/api/import', fisier).pipe(timeout(1000))this.http.post('/api/import', fisier).pipe(timeout(60000))Operațiile grele au nevoie de limite mai mari; alege limita după durata normală, nu după cea ideală.
3timeout pe un flux care emite rar
this.notificari$.pipe(timeout(3000)) // emite doar când apare ceva nouthis.notificari$.pipe(timeout({ first: 3000 }))Forma { first } verifică doar prima valoare; după ea, pauzele lungi sunt permise.
Repară eroarea, direct în pagină
Serviciul RapoarteApi răspunde după 600 ms, iar componenta pune timeout(200), așa că apare „TimeoutError: Timeout has occurred” și p#stare rămâne la „Se încarcă...”. Păstrează limita și tratează expirarea cu catchError, ca p#stare să afișeze „Serverul răspunde greu. Încearcă din nou.”.
import { Component, inject, signal } from '@angular/core';
import { timeout, catchError, of, TimeoutError } from 'rxjs';
import { RapoarteApi } from './rapoarte-api';
@Component({
selector: 'app-root',
template: `<p id="stare">{{ stare() }}</p>`
})
export class App {
private api = inject(RapoarteApi);
stare = signal('Se încarcă...');
constructor() {
this.api
.vanzari()
.pipe(timeout(200))
.subscribe((r) => this.stare.set(`Vânzări: ${r.total} lei`));
}
}Indiciu
Verifică în catchError dacă eroarea este TimeoutError.
Reparația
import { Component, inject, signal } from '@angular/core';
import { timeout, catchError, of, TimeoutError } from 'rxjs';
import { RapoarteApi } from './rapoarte-api';
@Component({
selector: 'app-root',
template: `<p id="stare">{{ stare() }}</p>`
})
export class App {
private api = inject(RapoarteApi);
stare = signal('Se încarcă...');
constructor() {
this.api
.vanzari()
.pipe(
timeout(200),
catchError((e) => {
if (e instanceof TimeoutError) {
this.stare.set('Serverul răspunde greu. Încearcă din nou.');
return of(null);
}
throw e;
})
)
.subscribe((r) => {
if (r) this.stare.set(`Vânzări: ${r.total} lei`);
});
}
}De ce merge
timeout(200) oprește așteptarea după 200 ms și trimite TimeoutError prin flux. Fără tratare, eroarea nu ajunge în subscribe, iar textul de încărcare rămâne pe ecran.
catchError prinde eroarea, verifică tipul cu instanceof TimeoutError, setează mesajul și întoarce of(null). Funcția din subscribe primește null și nu mai suprascrie mesajul, iar alte erori sunt aruncate mai departe.
Alte forme ale mesajului
ERROR TimeoutErrorImpl: Timeout has occurredError: Timeout has occurred
Cum o eviți pe viitor
- Pune
catchErrordupă fiecaretimeoutși arată un mesaj util. - Alege limita după operație: câteva secunde pentru citiri, mai mult pentru importuri și rapoarte.
- Combină
timeoutcuretry({ count: 2, delay: 1000 })pentru probleme de moment. - Pentru o limită comună tuturor cererilor, folosește un interceptor.
Întrebări frecvente
Cum deosebesc expirarea de alte erori în catchError?
Verifică e instanceof TimeoutError (importat din rxjs). Pentru erorile HTTP, obiectul este HttpErrorResponse, cu status.
Cererea HTTP e anulată când expiră timpul?
Da. La expirare, timeout se dezabonează de la sursă, iar HttpClient anulează cererea. În tab-ul Network o vezi marcată ca anulată (canceled).
Erori înrudite
EmptyError: no elements in sequence Ai folosit first(), last(), single() sau firstValueFrom()/lastValueFrom() pe un flux care s-a terminat fără nicio valoare (gol sau filtrat complet). Dă o valoare implicită: first(cond, valoareImplicita), sau folosește take(1), care nu aruncă eroare. TypeError: You provided 'undefined' where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable. Un operator care așteaptă un Observable (switchMap, mergeMap, concatMap, catchError, forkJoin) a primit undefined. De obicei funcția dată operatorului are acolade și nu are return. Întoarce Observable-ul din funcție. forkJoin nu emite nimic: unul dintre Observable-uri nu se termină (BehaviorSubject, interval, valueChanges) forkJoin emite o singură dată, după ce TOATE fluxurile primite s-au terminat (complete). Dacă unul e un Subject, BehaviorSubject, interval sau valueChanges, nu se termină niciodată și forkJoin nu emite. Adaugă take(1) la acel flux sau folosește combineLatest. Î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.
