...
Eroare Angular · RxJS și abonamente

TimeoutError: Timeout has occurred

Pe scurt

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

Greșit
TypeScript
this.http.get('/api/raport').pipe(timeout(5000))
  .subscribe((r) => this.raport.set(r));
Corect
TypeScript
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

Greșit
TypeScript
this.http.post('/api/import', fisier).pipe(timeout(1000))
Corect
TypeScript
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

Greșit
TypeScript
this.notificari$.pipe(timeout(3000)) // emite doar când apare ceva nou
Corect
TypeScript
this.notificari$.pipe(timeout({ first: 3000 }))

Forma { first } verifică doar prima valoare; după ea, pauzele lungi sunt permise.

Repară tu

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

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

Alte forme ale mesajului

  • ERROR TimeoutErrorImpl: Timeout has occurred
  • Error: Timeout has occurred

Cum o eviți pe viitor

  • Pune catchError după fiecare timeout și arată un mesaj util.
  • Alege limita după operație: câteva secunde pentru citiri, mai mult pentru importuri și rapoarte.
  • Combină timeout cu retry({ 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

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