...
Eroare Angular · RxJS și abonamente

TypeError: You provided 'undefined' where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.

Pe scurt

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

Greșit
TypeScript
switchMap((termen) => {
  this.http.get(`/api/cauta?q=${termen}`);
})
Corect
TypeScript
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

Greșit
TypeScript
catchError(() => {
  this.eroare.set('Nu s-au putut încărca datele.');
})
Corect
TypeScript
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

Greșit
TypeScript
detalii(id: number) {
  this.http.get(`/api/produse/${id}`);
}
// ...switchMap((id) => this.api.detalii(id))
Corect
TypeScript
detalii(id: number) {
  return this.http.get(`/api/produse/${id}`);
}

switchMap primește ce întoarce metoda; fără return, primește undefined.

Repară tu

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.

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

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 / mergeMap când fac un singur lucru.
  • Când ai nevoie de acolade (mai multe instrucțiuni), verifică să existe return pe 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

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