...
Eroare Angular · RxJS și abonamente

NG0601: `toSignal()` called with `requireSync` but `Observable` did not emit synchronously.

Pe scurt

Ai cerut toSignal(obs$, { requireSync: true }), dar Observable-ul (de obicei o cerere HTTP) nu are o valoare imediat. Folosește initialValue pentru o valoare de pornire, sau lasă signal-ul să fie undefined până sosesc datele.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un signal are mereu o valoare. Când transformi un Observable cu toSignal, Angular trebuie să știe ce valoare are signal-ul până la prima emisie. Implicit e undefined; cu initialValue alegi tu una; iar cu requireSync: true promiți că Observable-ul emite sincron, chiar în momentul abonării, deci nu e nevoie de valoare inițială.

Promisiunea e adevărată pentru BehaviorSubject, of(...) sau un flux cu startWith(...). Pentru o cerere HttpClient, un timer sau orice valoare care sosește mai târziu, nu e: la abonare nu vine nimic, iar Angular aruncă NG0601 imediat, la crearea componentei.

Avantajul lui requireSync e tipul: signal-ul nu mai include undefined. Dacă vrei același avantaj pentru date asincrone, folosește initialValue cu o valoare de același tip (listă goală, obiect implicit).

De ce apare: cauzele frecvente

1requireSync pe o cerere HTTP

Greșit
TypeScript
produse = toSignal(this.http.get<Produs[]>('/api/produse'), { requireSync: true });
Corect
TypeScript
produse = toSignal(this.http.get<Produs[]>('/api/produse'), { initialValue: [] });

Lista goală e valoarea până sosește răspunsul; tipul rămâne Signal<Produs[]>.

2Subject în loc de BehaviorSubject

Greșit
TypeScript
private tema$ = new Subject<string>();
tema = toSignal(this.tema$, { requireSync: true });
Corect
TypeScript
private tema$ = new BehaviorSubject('luminoasa');
tema = toSignal(this.tema$, { requireSync: true });

BehaviorSubject are mereu o valoare curentă și o emite imediat la abonare.

3Operator asincron în lanț

Greșit
TypeScript
toSignal(of(1).pipe(delay(0)), { requireSync: true })
Corect
TypeScript
toSignal(of(1).pipe(delay(0), startWith(0)), { requireSync: true })

startWith emite sincron o primă valoare, deci promisiunea requireSync e respectată.

Repară tu

Repară eroarea, direct în pagină

Utilizatorul vine de la /api/eu prin toSignal(..., { requireSync: true }), iar aplicația se oprește cu „NG0601: toSignal() called with requireSync but Observable did not emit synchronously”. Înlocuiește requireSync cu o valoare inițială { nume: '...' }, ca p#salut să afișeze „Bun venit, Elena!”.

Codul care dă eroarea
TypeScript
import { Component, inject } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { toSignal } from '@angular/core/rxjs-interop';

interface Utilizator { nume: string; }

@Component({
  selector: 'app-root',
  template: `<p id="salut">Bun venit, {{ utilizator().nume }}!</p>`
})
export class App {
  private http = inject(HttpClient);
  utilizator = toSignal(this.http.get<Utilizator>('/api/eu'), { requireSync: true });
}
Indiciu

O cerere HTTP nu are niciodată o valoare chiar în momentul abonării.

Alte forme ale mesajului

  • Error: NG0601: `toSignal()` called with `requireSync` but `Observable` did not emit synchronously. Find more at https://angular.dev/errors/NG0601

Cum o eviți pe viitor

  • Pentru date de la server folosește initialValue (sau acceptă undefined și tratează-l în șablon cu @if).
  • Păstrează requireSync pentru BehaviorSubject, fluxuri cu startWith sau stări din servicii care au mereu o valoare.
  • Când nu ești sigur, alege initialValue: nu poate arunca eroarea.

Întrebări frecvente

Ce valoare are signal-ul fără initialValue și fără requireSync?

undefined până la prima emisie. Tipul devine Signal<T | undefined>, deci în șablon folosești ?. sau @if (produse(); as lista).

De ce eroarea apare la pornire, nu când sosesc datele?

Verificarea se face imediat după abonare, în constructor: dacă nu a venit nicio valoare sincron, Angular știe deja că promisiunea requireSync a fost încălcată.

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.