NG8102: The left side of this nullish coalescing operation does not include 'null' or 'undefined' in its type, therefore the '??' operator can be safely removed.
Folosești ?? pe o valoare care, după tipul ei, nu poate fi null sau undefined, deci partea din dreapta nu se afișează niciodată. Fie scoți ??, fie (des) tipul e greșit: declară valoarea ca number | null dacă poate lipsi.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Operatorul ?? (nullish coalescing) întoarce partea din dreapta doar când partea din stânga e null sau undefined. NG8102 (diagnostic extins nullishCoalescingNotNullable) îți spune că, după tipul ei, valoarea din stânga nu poate fi niciodată așa, deci ?? ... e cod mort.
Două interpretări posibile. Dacă valoarea chiar e mereu prezentă, scoți ??. Dar de multe ori problema e în model: valoarea poate lipsi (un preț necunoscut, o dată nesetată), dar a fost declarată cu o valoare „de umplutură”, 0 sau ''. Atunci textul alternativ nu apare niciodată, iar utilizatorul vede „0 lei” în loc de „Preț la cerere”.
Atenție și la diferența față de ||: ?? nu tratează 0 și '' ca lipsă, doar null și undefined.
De ce apare: cauzele frecvente
1Valoare lipsă reprezentată prin 0
pret = signal(0);
// șablon:
{{ pret() ?? 'Preț la cerere' }}pret = signal<number | null>(null);
// șablon:
{{ pret() ?? 'Preț la cerere' }}Cu null pentru „necunoscut”, ?? are sens și textul alternativ apare.
2?? pe o valoare mereu prezentă
titlu = input('Produs');
// șablon:
{{ titlu() ?? 'Fără titlu' }}titlu = input('Produs');
// șablon:
{{ titlu() }}Input-ul are valoare implicită, deci nu poate fi null; ?? e inutil.
3?? confundat cu ||
nota = signal('');
// șablon:
{{ nota() ?? 'Fără observații' }}{{ nota() || 'Fără observații' }}Un text gol nu e null; dacă vrei să tratezi și '', folosește ||.
Repară eroarea, direct în pagină
Pentru produsele fără preț stabilit, #pret trebuie să afișeze „Preț la cerere”. Starter-ul reprezintă prețul necunoscut prin 0, așa că ?? nu se aplică niciodată (la build: NG8102) și pe ecran apare „0”. Declară prețul ca signal<number | null>(null), ca textul alternativ să apară.
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<h2>Canapea extensibilă</h2>
<p id="pret">{{ pret() ?? 'Preț la cerere' }}</p>
`
})
export class App {
pret = signal(0);
}Indiciu
Pentru „necunoscut” folosește null, iar tipul number | null.
Reparația
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<h2>Canapea extensibilă</h2>
<p id="pret">{{ pret() ?? 'Preț la cerere' }}</p>
`
})
export class App {
pret = signal<number | null>(null);
}De ce merge
Cu signal(0), tipul prețului e number, care nu include null. Compilatorul vede că ?? nu se poate aplica niciodată (NG8102), iar la rulare valoarea 0 e afișată ca atare, pentru că 0 nu e „nullish”.
Cu signal<number | null>(null), prețul necunoscut e chiar null. Acum ?? are rost: afișează „Preț la cerere” până când prețul primește o valoare, iar compilatorul nu mai avertizează.
Alte forme ale mesajului
WARNING: NG8102: The left side of this nullish coalescing operation does not include 'null' or 'undefined' in its type, therefore the '??' operator can be safely removed.warning NG8102: The left side of this nullish coalescing operation does not include 'null' or 'undefined' in its type
Cum o eviți pe viitor
- Reprezintă „lipsa valorii” cu
nullsauundefinedși include-le în tip, nu cu0sau''. - Folosește
??doar pe valori care chiar pot lipsi;||când vrei să tratezi și0/''. - Când primești NG8102, întreabă-te întâi dacă tipul e corect, abia apoi șterge
??. - Păstrează diagnosticele extinse activate: semnalează modele de date înșelătoare.
Întrebări frecvente
Ce diferență e între ?? și ||?
a ?? b dă b doar când a e null sau undefined. a || b dă b pentru orice valoare falsă: 0, '', false, null, undefined. Pentru prețuri și cantități, unde 0 e valid, ?? e de obicei corect.
Avertismentul oprește build-ul?
Implicit nu, e un avertisment. Poți configura diagnosticele extinse să fie erori ("defaultCategory": "error") ca să nu ajungă în cod.
Erori înrudite
NG8107: The left side of this optional chain operation does not include 'null' or 'undefined' in its type, therefore the '?.' operator can be replaced with the '.' operator. Ai folosit ?. pe o valoare care, după tipul ei, nu poate fi null sau undefined. Des, valoarea e un signal necitit (produs?.nume în loc de produs().nume). Citește signal-ul cu () și scoate ?. acolo unde nu e nevoie. TS2322: Type 'string' is not assignable to type 'number'. Un input de tip number primește un text: <app-card pret="25" /> trimite șirul "25", nu numărul 25. Folosește binding de proprietate, [pret]="25", sau transformă atributul cu input(0, { transform: numberAttribute }). TS2532: Object is possibly 'undefined'. TypeScript (și verificarea strictă a șabloanelor) vede că valoarea poate fi undefined, de exemplu rezultatul lui find(), și refuză să-i citești proprietățile direct. Tratează cazul: @if (produs(); as p), produs()?.nume sau o valoare implicită cu ??. Î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.
