...
Eroare Angular · Teste cu TestBed

TypeError: Cannot read properties of null (reading 'textContent') (querySelector într-un test de componentă)

Pe scurt

În test, nativeElement.querySelector(...) a întors null: selectorul nu se potrivește (id în loc de clasă, nume greșit) sau elementul încă nu există (lipsește detectChanges, e într-un @if fals). Verifică selectorul față de șablon și randează înainte de căutare.

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

Ce înseamnă

querySelector întoarce null când nu găsește niciun element. Următorul pas, .textContent sau .click(), se face pe null, iar JavaScript se oprește cu Cannot read properties of null. Numele din paranteză îți spune ce încercai să citești, nu ce element lipsea: uită-te la linia indicată și la selectorul de pe ea.

În testele de componente, cauzele sunt aproape mereu trei: selectorul diferă de șablon (#total când elementul are class="total"), elementul apare doar după o condiție (@if, date încărcate, un click), sau șablonul nu a fost încă randat pentru că lipsește fixture.detectChanges().

Operatorul ! (querySelector(...)!) doar convinge TypeScript că valoarea nu e null; la rulare nu schimbă nimic.

De ce apare: cauzele frecvente

1Id în loc de clasă

Greșit
TypeScript
// șablon: <span class="cantitate">
el.querySelector('#cantitate')!.textContent
Corect
TypeScript
el.querySelector('.cantitate')!.textContent

# caută după id, . după clasă; selectorul trebuie să corespundă șablonului.

2Element condiționat de @if

Greșit
TypeScript
fixture.detectChanges();
el.querySelector('.eroare')!.textContent; // apare doar după trimiterea formularului
Corect
TypeScript
el.querySelector<HTMLButtonElement>('#trimite')!.click();
fixture.detectChanges();
expect(el.querySelector('.eroare')?.textContent).toContain('obligatoriu');

Elementul există în DOM abia după acțiunea care face condiția adevărată.

3Căutare înainte de randare

Greșit
TypeScript
const fixture = TestBed.createComponent(Lista);
fixture.nativeElement.querySelector('li').textContent;
Corect
TypeScript
const fixture = TestBed.createComponent(Lista);
fixture.detectChanges();
fixture.nativeElement.querySelector('li').textContent;

Elementele generate de @for apar doar după prima detectare a schimbărilor.

Repară tu

Repară eroarea, direct în pagină

Testul „crește cantitatea la plus” se oprește cu „Cannot read properties of null”. Componenta (din app.ts) are butonul cu class="plus" și cantitatea în span cu class="cantitate". Repară selectorul din test ca testul să treacă.

Codul care dă eroarea
TypeScript
import { TestBed } from '@angular/core/testing';
import { App } from './app';

describe('App', () => {
  it('crește cantitatea la plus', () => {
    const fixture = TestBed.createComponent(App);
    fixture.detectChanges();
    const el: HTMLElement = fixture.nativeElement;

    el.querySelector<HTMLButtonElement>('.plus')!.click();
    fixture.detectChanges();

    expect(el.querySelector('#cantitate')!.textContent).toBe('2');
  });
});
După reparație, programul afișează
✓ App > crește cantitatea la plus
Teste: 1 trecute, 0 picate
Indiciu

Compară selectorii din test cu atributele din șablonul componentei.

Alte forme ale mesajului

  • TypeError: Cannot read properties of null (reading 'click')
  • TypeError: Cannot read property 'textContent' of null
  • TypeError: el.querySelector(...) is null

Cum o eviți pe viitor

  • Dă elementelor testate selectori stabili (data-testid="total" sau o clasă clară) și folosește aceiași în teste.
  • Folosește ?. în aserțiuni (querySelector('.x')?.textContent): testul pică cu un mesaj despre valoare, nu cu TypeError.
  • Verifică întâi existența: expect(el.querySelector('.x')).toBeTruthy().
  • Randează (detectChanges) după fiecare acțiune înainte de căutare.

Întrebări frecvente

De ce eroarea nu spune ce selector a eșuat?

Pentru JavaScript, querySelector a reușit: a întors null. Eroarea apare la pasul următor, care nu mai știe de unde venea valoarea. De aceea linia din stiva de apeluri e cea mai bună pistă.

Ce e mai bine: nativeElement.querySelector sau debugElement.query(By.css())?

Ambele funcționează. nativeElement.querySelector e API-ul DOM obișnuit; debugElement.query(By.css(...)) întoarce un DebugElement cu acces la componenta și injectorul elementului, util în teste mai avansate.

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.