Cannot read properties of null (reading 'oras')
Expresia citește un câmp dintr-o valoare care e null: de exemplu $json.adresa.oras când unii clienți au adresa null. Folosește optional chaining și o valoare implicită: {{ $json.adresa?.oras ?? 'necunoscut' }}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spre deosebire de undefined (câmpul lipsește), null înseamnă că API-ul a trimis câmpul, dar fără valoare. Rezultatul e același: nu poți citi oras din null, iar n8n se oprește cu Cannot read properties of null (reading 'oras').
Foarte des, doar unele item-uri au null (clienți fără adresă, comenzi fără curier), deci expresia merge la primul item și cade la al treilea. Previzualizarea arată de obicei doar primul item, așa că problema nu se vede până la rulare.
Reparația standard: ?. (optional chaining) oprește citirea la null/undefined și dă undefined, iar ?? pune o valoare de rezervă: {{ $json.adresa?.oras ?? 'necunoscut' }}.
De ce apare: cauzele frecvente
1Adresă null
{{ $json.adresa.oras }}{{ $json.adresa?.oras ?? 'necunoscut' }}?. nu mai citește mai departe dacă adresa e null.
2Lanț lung
{{ $json.livrare.curier.nume }}{{ $json.livrare?.curier?.nume ?? 'fără curier' }}Fiecare nivel poate lipsi.
3|| vs ??
{{ $json.reducere || 10 }} (reducere 0 devine 10){{ $json.reducere ?? 10 }}?? înlocuiește doar null și undefined, nu și 0.
Repară eroarea, direct în pagină
Edit Fields extrage orașul clienților cu {{ $json.adresa.oras }}, dar Mihai Ionescu are adresa: null, iar nodul se oprește („Cannot read properties of null”). Folosește {{ $json.adresa?.oras ?? 'necunoscut' }} și rulează: Ana trebuie să aibă Cluj-Napoca, iar Mihai necunoscut.
Indiciu
?. oprește citirea la null; ?? pune valoarea de rezervă.
Reparația
1. Edit Fields → oras = {{ $json.adresa?.oras ?? 'necunoscut' }}. 2. Execute workflow: Cluj-Napoca, necunoscut.
De ce merge
La Mihai, adresa e null, deci .oras nu se poate citi. Cu ?., expresia dă undefined în loc de eroare, iar ?? îl înlocuiește cu „necunoscut”. La Ana, adresa există și expresia dă orașul.
Alte forme ale mesajului
Cannot read properties of null (reading 'nume')TypeError: Cannot read properties of null
Cum o eviți pe viitor
- Pentru câmpuri opționale, folosește mereu ?. și ??.
- Rulează pe toate item-urile, nu te baza doar pe previzualizarea primului.
- Filtrează devreme item-urile incomplete, dacă nu le poți procesa.
Întrebări frecvente
Care e diferența dintre null și undefined aici?
undefined: câmpul nu există; null: există, dar e gol. Pentru expresii, ?. și ?? le tratează la fel.
Pot folosi $ifEmpty?
Da: {{ $ifEmpty($json.adresa?.oras, 'necunoscut') }} tratează și textul gol.
Erori înrudite
Cannot read properties of undefined (reading 'oras') Expresia încearcă să citească un câmp (aici oras) dintr-un obiect care nu există pentru item-ul curent, de exemplu $json.adresa.oras când adresa lipsește. Verifică numele câmpului în Output-ul nodului anterior și folosește ?. și ?? pentru câmpurile opționale. undefined în textul generat (Bună, undefined!) Codul citește un câmp care nu există (nume scris greșit, majuscule diferite sau câmp aflat mai adânc), iar JavaScript pune cuvântul undefined în text. Verifică numele exact al câmpului în Input și, pentru câmpurile opționale, pune o valoare implicită cu ??. TypeError: item.json.produse is not iterable Ai folosit for...of (sau spread ...) pe o valoare care nu e listă: null, undefined sau un obiect. Unele item-uri nu au lista. Pune o listă goală de rezervă: for (const p of item.json.produse ?? []). Învață n8n de la zero, cu exerciții la fiecare lecție
Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
