...
Eroare Angular · Verificarea tipurilor în șabloane și TypeScript

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.

Pe scurt

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

Greșit
TypeScript
pret = signal(0);
// șablon:
{{ pret() ?? 'Preț la cerere' }}
Corect
TypeScript
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ă

Greșit
TypeScript
titlu = input('Produs');
// șablon:
{{ titlu() ?? 'Fără titlu' }}
Corect
TypeScript
titlu = input('Produs');
// șablon:
{{ titlu() }}

Input-ul are valoare implicită, deci nu poate fi null; ?? e inutil.

3?? confundat cu ||

Greșit
TypeScript
nota = signal('');
// șablon:
{{ nota() ?? 'Fără observații' }}
Corect
TypeScript
{{ nota() || 'Fără observații' }}

Un text gol nu e null; dacă vrei să tratezi și '', folosește ||.

Repară tu

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

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

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 null sau undefined și include-le în tip, nu cu 0 sau ''.
  • Folosește ?? doar pe valori care chiar pot lipsi; || când vrei să tratezi și 0 / ''.
  • 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

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