NG0601: `toSignal()` called with `requireSync` but `Observable` did not emit synchronously.
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
produse = toSignal(this.http.get<Produs[]>('/api/produse'), { requireSync: true });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
private tema$ = new Subject<string>();
tema = toSignal(this.tema$, { requireSync: true });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ț
toSignal(of(1).pipe(delay(0)), { requireSync: true })toSignal(of(1).pipe(delay(0), startWith(0)), { requireSync: true })startWith emite sincron o primă valoare, deci promisiunea requireSync e respectată.
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!”.
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.
Reparația
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'), { initialValue: { nume: '...' } });
}De ce merge
Cu requireSync: true, toSignal se abonează și se așteaptă la o valoare imediat. Cererea HTTP răspunde abia după câteva milisecunde, deci la verificare signal-ul nu are nimic și Angular aruncă NG0601.
Cu initialValue: { nume: '...' }, signal-ul pornește cu un obiect valid, șablonul poate citi .nume fără erori, iar când sosește răspunsul, valoarea e înlocuită cu { nume: 'Elena' }.
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ă
requireSyncpentruBehaviorSubject, fluxuri custartWithsau 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
NG0203: toSignal() can only be used within an injection context such as a constructor, a factory function, a field initializer, or a function used with `runInInjectionContext`. toSignal() are nevoie de contextul de injectare (ca să se dezaboneze singur la distrugerea componentei), dar l-ai apelat în ngOnInit, într-o metodă sau într-un callback. Mută-l la inițializarea unui câmp sau în constructor. NG02100: InvalidPipeArgument: '[object Object]' for pipe 'AsyncPipe' Pipe-ul async primește doar Observable sau Promise, dar i-ai dat altceva: un obiect, un tablou deja primit sau un signal. Scoate | async (pentru signal citește-l cu ()), sau dă-i Observable-ul, nu datele. TypeError: total.subscribe is not a function Apelezi .subscribe() pe un signal (signal, computed, input, toSignal). Signals nu au subscribe: ca să derivezi o valoare folosești computed(), ca să reacționezi la schimbări effect(), iar dacă ai nevoie de RxJS, toObservable(). Î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.
