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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Unii operatori promit că vor emite exact o valoare: first() prima, last() ultima, single() singura. Funcțiile firstValueFrom și lastValueFrom fac la fel, dar întorc o promisiune. Dacă fluxul se termină (complete) fără să fi trecut nicio valoare, promisiunea lor nu poate fi respectată și RxJS aruncă EmptyError: no elements in sequence.
Cazurile tipice: first(conditie) pe o listă în care niciun element nu respectă condiția; filter(...) urmat de first(); lastValueFrom(EMPTY) sau al unui flux oprit de takeUntil înainte de prima valoare; o cerere HttpClient cu observe: 'events' filtrată greșit.
take(1) este alternativa care nu aruncă: dacă fluxul se termină gol, pur și simplu nu emite nimic. Alegerea depinde de ce înseamnă „gol” pentru aplicația ta: o eroare reală sau un caz normal.
De ce apare: cauzele frecvente
1first cu o condiție pe care nu o respectă nimeni
from(comenzi).pipe(first((c) => c.status === 'anulata'))from(comenzi).pipe(first((c) => c.status === 'anulata', null))Al doilea argument este valoarea emisă când nicio comandă nu respectă condiția; în loc de eroare primești null.
2lastValueFrom pe un flux fără valori
const ultima = await lastValueFrom(this.notificari$.pipe(takeUntil(this.inchide$)));const ultima = await lastValueFrom(
this.notificari$.pipe(takeUntil(this.inchide$)),
{ defaultValue: null }
);defaultValue este folosită când fluxul se termină gol.
3first() când e suficient take(1)
this.cautare$.pipe(filter((t) => t.length > 2), first())this.cautare$.pipe(filter((t) => t.length > 2), take(1))take(1) ia prima valoare dacă există și se termină liniștit dacă nu.
Repară eroarea, direct în pagină
Aplicația caută prima comandă anulată cu first(...), dar nicio comandă nu e anulată și apare „EmptyError: no elements in sequence”. Dă operatorului first valoarea implicită null și afișează în p#anulata textul „Nicio comandă anulată.” când nu există.
import { Component, signal } from '@angular/core';
import { from, first } from 'rxjs';
interface Comanda { cod: string; status: string; }
@Component({
selector: 'app-root',
template: `<p id="anulata">{{ mesaj() }}</p>`
})
export class App {
comenzi: Comanda[] = [
{ cod: 'C-101', status: 'livrata' },
{ cod: 'C-102', status: 'in curs' }
];
mesaj = signal('');
constructor() {
from(this.comenzi)
.pipe(first((c) => c.status === 'anulata'))
.subscribe((c) => this.mesaj.set(`Prima comandă anulată: ${c.cod}`));
}
}Indiciu
first acceptă un al doilea argument: valoarea emisă când nimic nu respectă condiția.
Reparația
import { Component, signal } from '@angular/core';
import { from, first } from 'rxjs';
interface Comanda { cod: string; status: string; }
@Component({
selector: 'app-root',
template: `<p id="anulata">{{ mesaj() }}</p>`
})
export class App {
comenzi: Comanda[] = [
{ cod: 'C-101', status: 'livrata' },
{ cod: 'C-102', status: 'in curs' }
];
mesaj = signal('');
constructor() {
from(this.comenzi)
.pipe(first((c) => c.status === 'anulata', null))
.subscribe((c) => this.mesaj.set(c ? `Prima comandă anulată: ${c.cod}` : 'Nicio comandă anulată.'));
}
}De ce merge
from(this.comenzi) emite cele două comenzi și apoi se termină. Cum niciuna nu are statusul anulata, first ajunge la final fără nicio valoare și aruncă EmptyError, pentru că a promis exact o valoare.
Cu first(conditie, null), operatorul emite null în loc de eroare. Funcția din subscribe verifică valoarea și alege mesajul potrivit, deci aplicația tratează și cazul în care lista nu conține ce cauți.
Alte forme ale mesajului
ERROR EmptyError: no elements in sequenceEmptyErrorImpl: no elements in sequenceError: no elements in sequence
Cum o eviți pe viitor
- Folosește
first()/single()doar când lipsa valorii e chiar o eroare; altfel dă o valoare implicită. - Pentru „ia prima valoare, dacă există”, folosește
take(1). - La
firstValueFrom/lastValueFrom, pune{ defaultValue: ... }când fluxul poate fi gol. - Tratează eroarea cu
catchErrordacă vrei un mesaj specific pentru „nu am găsit”.
Întrebări frecvente
Care e diferența dintre first() și take(1)?
Ambele iau prima valoare și termină fluxul. Diferența apare la fluxul gol: first() aruncă EmptyError, take(1) se termină fără valoare și fără eroare.
De ce eroarea apare doar uneori?
Depinde de date: cât timp lista conține un element care respectă condiția, first îl găsește. Eroarea apare abia când datele nu mai conțin un astfel de element, de exemplu pentru un client nou.
Erori înrudite
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. 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. 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. Î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.
