TypeError: Cannot read properties of null (reading 'textContent') (querySelector într-un test de componentă)
Î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ă
// șablon: <span class="cantitate">
el.querySelector('#cantitate')!.textContentel.querySelector('.cantitate')!.textContent# caută după id, . după clasă; selectorul trebuie să corespundă șablonului.
2Element condiționat de @if
fixture.detectChanges();
el.querySelector('.eroare')!.textContent; // apare doar după trimiterea formularuluiel.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
const fixture = TestBed.createComponent(Lista);
fixture.nativeElement.querySelector('li').textContent;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ă 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ă.
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');
});
});✓ App > crește cantitatea la plus Teste: 1 trecute, 0 picate
Indiciu
Compară selectorii din test cu atributele din șablonul componentei.
Reparația
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');
});
});De ce merge
Șablonul pune cantitatea într-un span cu class="cantitate", iar testul o caută după id (#cantitate). querySelector('#cantitate') întoarce null, iar .textContent pe null aruncă TypeError; operatorul ! nu ajută la rulare.
Cu .cantitate, testul găsește elementul: click-ul crește signal-ul, detectChanges() actualizează textul, iar aserțiunea vede „2”.
Alte forme ale mesajului
TypeError: Cannot read properties of null (reading 'click')TypeError: Cannot read property 'textContent' of nullTypeError: 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
Expected '' to be 'Bun venit, Ana!'. (testul nu apelează fixture.detectChanges()) TestBed.createComponent creează componenta, dar nu-i randează legăturile din șablon: textul din {{ }} rămâne gol până la primul fixture.detectChanges() (sau await fixture.whenStable()). Apelează-l după creare și după fiecare schimbare. NG0303: Can't set value of the 'title' input on the 'Card' component. Make sure that the 'title' property is declared as an input using the input() or model() function or the @Input() decorator. fixture.componentRef.setInput('title', ...) folosește un nume de input care nu există în componentă (aici inputul se numește titlu). Folosește exact numele (sau aliasul) declarat cu input(), model() sau @Input(). Expected spy pentru to have been called with: [ 'Ana' ] but it was never called. Spionul a fost creat după ce componenta apelase deja metoda (în ngOnInit, la primul detectChanges), deci n-a „văzut” apelul. Creează spionul (vi.spyOn / spyOn) înainte de createComponent și detectChanges, sau verifică dacă metoda chiar e apelată. Î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.
