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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din JavaScript, pe care n8n îl folosește pentru expresii și pentru nodul Code. Cannot read properties of undefined (reading 'oras') înseamnă: ai cerut .oras dintr-o valoare care este undefined. Partea interesantă nu e oras, ci ce e înaintea lui: în $json.adresa.oras, $json.adresa lipsește.
Cauzele tipice: numele câmpului e scris diferit (Adresa vs adresa), datele sunt mai adânc decât crezi (la Webhook totul e sub body, deci $json.body.adresa.oras), sau doar unele item-uri au câmpul. Ultima e cea mai perfidă: primul item merge, al treilea nu.
Cum depanezi: deschide Output-ul nodului anterior în vizualizarea JSON și caută item-ul la care se oprește (n8n spune adesea [item 2]). Trage câmpul cu mouse-ul din panoul Input în parametru: n8n scrie singur calea corectă.
De ce apare: cauzele frecvente
1Câmpul lipsește la unele item-uri
{{ $json.adresa.oras }}{{ $json.adresa?.oras ?? 'necunoscut' }}?. se oprește fără eroare când adresa lipsește și dă undefined; ?? pune o valoare implicită.
2Datele de la Webhook sunt sub body
{{ $json.adresa.oras }}{{ $json.body.adresa.oras }}Webhook-ul pune corpul cererii în body, lângă headers și query. $json.adresa nu există la nivelul de sus.
3Litere mari / mici diferite
{{ $json.Adresa.oras }}{{ $json.adresa.oras }}Numele câmpurilor sunt sensibile la majuscule. Adresa și adresa sunt câmpuri diferite.
Repară eroarea, direct în pagină
Nodul Livrare se oprește cu „Cannot read properties of undefined (reading 'oras')”, pentru că o comandă nu are adresa. Schimbă valoarea câmpului oras ca să devină necunoscut când adresa lipsește, apoi rulează: toate cele 3 comenzi trebuie să treacă.
Indiciu
Operatorul ?. se oprește fără eroare când obiectul lipsește.
Reparația
În Livrare, câmpul oras:
{{ $json.adresa?.oras ?? 'necunoscut' }}Execute workflow: 5001 → Cluj-Napoca, 5002 → București, 5003 → necunoscut.
De ce merge
$json.adresa.oras cere .oras din adresa; la comanda 5003 adresa nu există, deci JavaScript aruncă eroarea. $json.adresa?.oras dă undefined în loc de eroare, iar ?? 'necunoscut' îl înlocuiește cu un text clar. Comenzile care au adresă rămân neschimbate.
Alte forme ale mesajului
Cannot read properties of null (reading 'email')TypeError: Cannot read properties of undefined (reading 'json')Cannot read property 'oras' of undefined
Cum o eviți pe viitor
- Copiază căile trăgând câmpurile din panoul Input, nu le scrie de mână.
- Pentru datele venite din formulare, webhook-uri sau API-uri externe, presupune că orice câmp poate lipsi:
?.și??. - Testează cu toate item-urile, nu doar cu primul, și fixează (Pin data) un exemplu incomplet.
- Dacă un câmp e obligatoriu, validează-l devreme cu un If și trimite item-urile incomplete pe altă ramură.
Întrebări frecvente
De ce primul item merge și al treilea nu?
Expresia se calculează separat pentru fiecare item. Dacă doar al treilea client nu are adresa, doar acolo apare eroarea. Mesajul n8n are adesea [item 2] la final: numărătoarea începe de la 0.
Care e diferența dintre „of undefined” și „of null”?
undefined înseamnă că proprietatea nu există deloc. null înseamnă că există, dar API-ul a trimis explicit null (de exemplu "contact": null). Reparația e aceeași: $json.contact?.email ?? ''.
Erori înrudite
Can't get data for expression n8n nu poate calcula expresia pentru item-ul curent, de obicei pentru că nodul citit cu $('Nod') nu a rulat pentru acest item (e pe altă ramură) sau nu are date. Citește datele din nodurile aflate pe drumul item-ului curent sau rulează întâi nodurile de dinainte. Referenced node is unexecuted O expresie citește datele unui nod care nu a rulat în execuția curentă, de exemplu $('Setări').first().json.prag, iar „Setări” nu e legat pe drumul spre nodul tău. Leagă nodul înaintea celui care îl folosește (sau rulează-l întâi) și eroarea dispare. ReferenceError: nume is not defined Ai scris numele unui câmp ca și cum ar fi o variabilă, de exemplu {{ nume }} în loc de {{ $json.nume }}. În expresii, datele item-ului se citesc doar prin $json (sau $('Nod')). Adaugă $json. în față. Î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.
