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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Operatorii de „aplatizare” (switchMap, mergeMap, concatMap, exhaustMap), catchError și funcțiile ca forkJoin, from, merge primesc sau produc fluxuri interioare. RxJS acceptă ca flux interior un Observable, o promisiune, un tablou sau alt iterabil. Mesajul îți spune că a primit 'undefined' și listează formele acceptate.
Cea mai frecventă cauză: funcția din switchMap are acolade și creează cererea, dar nu o întoarce. Funcția întoarce undefined, iar RxJS se oprește când încearcă să se aboneze la el. Același lucru în catchError(() => { this.mesaj.set('...'); }), unde lipsește return of(...).
Alte cauze: un serviciu a cărui metodă nu întoarce nimic, o valoare dintr-un obiect care nu există (fluxuri[cheie]), sau un import circular care face ca un Observable exportat să fie încă undefined.
De ce apare: cauzele frecvente
1switchMap cu acolade, fără return
switchMap((termen) => {
this.http.get(`/api/cauta?q=${termen}`);
})switchMap((termen) => this.http.get(`/api/cauta?q=${termen}`))Fără acolade, săgeata întoarce automat cererea; cu acolade ai nevoie de return.
2catchError care nu întoarce nimic
catchError(() => {
this.eroare.set('Nu s-au putut încărca datele.');
})catchError(() => {
this.eroare.set('Nu s-au putut încărca datele.');
return of([]);
})catchError înlocuiește fluxul cu eroare cu fluxul întors; trebuie să existe unul.
3Metodă de serviciu fără return
detalii(id: number) {
this.http.get(`/api/produse/${id}`);
}
// ...switchMap((id) => this.api.detalii(id))detalii(id: number) {
return this.http.get(`/api/produse/${id}`);
}switchMap primește ce întoarce metoda; fără return, primește undefined.
Repară eroarea, direct în pagină
La click pe #jocuri, lista ar trebui să afișeze jocurile din catalog, dar aplicația se oprește cu „You provided 'undefined' where a stream was expected”. Repară funcția din switchMap ca ul#rezultate să afișeze cele 3 jocuri.
import { Component, signal } from '@angular/core';
import { Subject, of, delay, switchMap } from 'rxjs';
const CATALOG: Record<string, string[]> = {
carti: ['Ion', 'Enigma Otiliei'],
jocuri: ['Catan', 'Dixit', 'Azul']
};
@Component({
selector: 'app-root',
template: `
<button id="jocuri" (click)="categorie.next('jocuri')">Jocuri</button>
<ul id="rezultate">
@for (p of produse(); track p) { <li>{{ p }}</li> }
</ul>
`
})
export class App {
categorie = new Subject<string>();
produse = signal<string[]>([]);
constructor() {
this.categorie
.pipe(
switchMap((c) => {
of(CATALOG[c]).pipe(delay(50));
})
)
.subscribe((l) => this.produse.set(l));
}
}Indiciu
Funcția din switchMap trebuie să întoarcă Observable-ul pe care îl creează.
Reparația
import { Component, signal } from '@angular/core';
import { Subject, of, delay, switchMap } from 'rxjs';
const CATALOG: Record<string, string[]> = {
carti: ['Ion', 'Enigma Otiliei'],
jocuri: ['Catan', 'Dixit', 'Azul']
};
@Component({
selector: 'app-root',
template: `
<button id="jocuri" (click)="categorie.next('jocuri')">Jocuri</button>
<ul id="rezultate">
@for (p of produse(); track p) { <li>{{ p }}</li> }
</ul>
`
})
export class App {
categorie = new Subject<string>();
produse = signal<string[]>([]);
constructor() {
this.categorie
.pipe(
switchMap((c) => of(CATALOG[c]).pipe(delay(50)))
)
.subscribe((l) => this.produse.set(l));
}
}De ce merge
switchMap apelează funcția pentru fiecare categorie și se abonează la ce primește înapoi. Funcția din starter creează of(...).pipe(delay(50)), dar fără return rezultatul se pierde, iar switchMap primește undefined și aruncă eroarea.
Forma fără acolade, (c) => of(CATALOG[c]).pipe(delay(50)), întoarce automat Observable-ul. switchMap se abonează la el, iar după 50 ms lista primește jocurile.
Alte forme ale mesajului
ERROR TypeError: You provided 'undefined' where a stream was expected. You can provide an Observable, Promise, Array, or Iterable.TypeError: You provided an invalid object where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.You provided 'null' where a stream was expected.
Cum o eviți pe viitor
- Folosește săgeți fără acolade pentru funcțiile din
switchMap/mergeMapcând fac un singur lucru. - Când ai nevoie de acolade (mai multe instrucțiuni), verifică să existe
returnpe fiecare ramură. - Declară tipul întors al metodelor de serviciu (
: Observable<Produs>): cu verificarea tipurilor, TypeScript prinde funcția fărăreturn.
Întrebări frecvente
Ce înseamnă „an invalid object” în loc de 'undefined'?
Ai întors ceva care nu e flux: un obiect simplu sau un număr. De exemplu switchMap(() => this.produse) unde produse e un tablou de obiecte merge, dar switchMap(() => ({ ok: true })) nu. Învelește valoarea cu of(...).
De ce funcționează cu map, dar nu cu switchMap?
map transformă valoarea și acceptă orice rezultat, inclusiv undefined. switchMap se abonează la rezultat, deci are nevoie de un flux.
Erori înrudite
TypeError: cerere.pipe is not a function Apelezi .pipe() pe ceva care nu e Observable: o promisiune (funcție async, fetch, firstValueFrom), un signal sau un tablou. Transformă valoarea în Observable cu from(...) sau folosește metodele potrivite tipului ei (then, computed, filter). Rezultatele vechi ale căutării înlocuiesc rezultatul nou (mergeMap în loc de switchMap) Cu mergeMap, fiecare termen de căutare pornește o cerere care rulează până la capăt; dacă una mai veche răspunde ultima, ea suprascrie rezultatul corect. Pentru căutări și filtre folosește switchMap, care anulează cererea anterioară. 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. Î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.
