...
Eroare n8n · Expresii și referințe la noduri

Cannot read properties of undefined (reading 'oras')

Pe scurt

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

Greșit
JSON
{{ $json.adresa.oras }}
Corect
JSON
{{ $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

Greșit
JSON
{{ $json.adresa.oras }}
Corect
JSON
{{ $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

Greșit
JSON
{{ $json.Adresa.oras }}
Corect
JSON
{{ $json.adresa.oras }}

Numele câmpurilor sunt sensibile la majuscule. Adresa și adresa sunt câmpuri diferite.

Repară tu

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.

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

← Toate erorile n8n

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ță 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.