...
Eroare JavaScript · Valori undefined și null

TypeError: Cannot read properties of null (reading 'textContent')

Pe scurt

Citești o proprietate dintr-o valoare `null`. În browser, aproape mereu e un element pe care `document.querySelector` sau `getElementById` nu l-a găsit (selector greșit sau script rulat înainte ca elementul să existe). În rest, o funcție sau o metodă a returnat `null` intenționat: verifică rezultatul înainte să îl folosești.

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

Ce înseamnă

La fel ca la undefined: în expresia ceva.textContent, ceva este null. Diferența e că null nu apare singur: este returnat explicit de cineva, ca să spună „nu există”.

Cei mai frecvenți „cineva”:

  • document.getElementById("id") și document.querySelector("..."), când elementul nu există în pagină (ID scris greșit, lipsă # sau . în selector, sau scriptul rulează în <head> înainte ca HTML-ul de dedesubt să fie citit);
  • "text".match(regex), când nu găsește nimic;
  • JSON.parse("null") sau date de la un server cu câmpuri null;
  • localStorage.getItem("cheie"), când cheia nu există.

Numele din paranteză este proprietatea pe care o citeai. Mergi la linia din stiva de apeluri și verifică de unde vine valoarea din stânga punctului.

De ce apare: cauzele frecvente

1match nu a găsit nimic

Greșit
JavaScript
const cod = "Comanda fara numar".match(/\d+/);
console.log(cod[0]);
Corect
JavaScript
const gasit = "Comanda fara numar".match(/\d+/);
console.log(gasit ? gasit[0] : "fără număr");

match returnează null când nu există potrivire, nu un tablou gol.

2Selector greșit în pagină

Greșit
JavaScript
const titlu = document.querySelector("titlu");
titlu.textContent = "Salut";
Corect
JavaScript
const titlu = document.querySelector("#titlu");
titlu.textContent = "Salut";

Fără #, selectorul caută un tag <titlu>, care nu există. Pentru ID pui #, pentru clasă ..

3Script rulat înainte de HTML

Greșit
JavaScript
<head>
  <script src="app.js"></script>
</head>
<body><p id="mesaj"></p></body>
Corect
JavaScript
<head>
  <script src="app.js" defer></script>
</head>
<body><p id="mesaj"></p></body>

Fără defer, scriptul rulează când elementele de mai jos încă nu există. defer (sau scriptul pus la finalul <body>) îl rulează după ce pagina a fost citită.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos extrage numărul de comandă din fiecare mesaj al clienților, dar unul dintre mesaje nu conține niciun număr și programul se oprește cu TypeError: Cannot read properties of null (reading '0'). Repară codul ca pentru mesajul fără număr să afișeze fără număr.

Codul care dă eroarea
JavaScript
const mesaje = [
  "Unde e comanda 1043?",
  "Vreau să returnez un produs",
  "Comanda 2210 a ajuns deteriorată"
];

for (const m of mesaje) {
  const gasit = m.match(/\d+/);
  console.log(gasit[0]);
}
După reparație, programul afișează
1043
fără număr
2210
Indiciu

Ce returnează match când nu găsește nimic? Verifică rezultatul înainte de [0].

Alte forme ale mesajului

  • TypeError: Cannot read properties of null (reading 'addEventListener')
  • TypeError: Cannot set properties of null (setting 'textContent')
  • TypeError: Cannot read property 'addEventListener' of null
  • TypeError: null is not an object (evaluating 'el.textContent')

Cum o eviți pe viitor

  • Pentru elemente din pagină, verifică ID-ul în HTML și selectorul în JavaScript (#id, .clasa).
  • Încarcă scripturile cu defer sau la finalul <body>.
  • Tratează rezultatele care pot fi null (match, querySelector, getItem) imediat după apel.
  • Folosește ?. doar dacă lipsa elementului e normală, altfel lasă eroarea să îți arate problema.

Întrebări frecvente

Care e diferența dintre null și undefined aici?

Ambele înseamnă „nu e nimic acolo”. undefined apare de obicei singur (variabilă fără valoare, proprietate lipsă), null e returnat intenționat de o funcție ca să spună „nu am găsit”.

Elementul există în HTML. De ce primesc totuși null?

Cel mai probabil scriptul rulează înaintea lui. Pune defer pe <script> sau mută scriptul la finalul <body>.

Erori înrudite

← Toate erorile JavaScript

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ță JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.