TypeError: Cannot read properties of null (reading 'textContent')
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")șidocument.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âmpurinull;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
const cod = "Comanda fara numar".match(/\d+/);
console.log(cod[0]);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ă
const titlu = document.querySelector("titlu");
titlu.textContent = "Salut";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
<head>
<script src="app.js"></script>
</head>
<body><p id="mesaj"></p></body><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ă 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.
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]);
}1043 fără număr 2210
Indiciu
Ce returnează match când nu găsește nimic? Verifică rezultatul înainte de [0].
Reparația
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 ? gasit[0] : "fără număr");
}De ce merge
match returnează un tablou cu potrivirea când găsește ceva și null când nu găsește nimic. La al doilea mesaj gasit era null, iar gasit[0] încerca să citească proprietatea 0 din null. Verificarea cu operatorul ternar tratează cazul: dacă există potrivire afișezi numărul, altfel textul de rezervă. Echivalent scurt: gasit?.[0] ?? "fără număr".
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 nullTypeError: 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
defersau 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
TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. TypeError: Cannot convert undefined or null to object Ai dat `undefined` sau `null` unei funcții care are nevoie de un obiect: `Object.keys`, `Object.values`, `Object.entries`, `Object.assign` sau `for...in` pe ceva care lipsește. Verifică de unde vine valoarea sau folosește un obiect gol ca rezervă: `Object.keys(date ?? {})`. ReferenceError: document is not defined Codul folosește `document` (sau `window`) într-un loc unde nu există pagină web: în Node.js, într-un Web Worker sau la randarea pe server. Rulează codul care lucrează cu pagina doar în browser, în scriptul paginii, și ține logica separat de DOM. Î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.
