Cannot set properties of undefined (setting 'oras')
În nodul Code încerci să scrii un câmp într-un obiect care nu există, de exemplu $json.livrare.oras = 'Cluj' când livrare lipsește. Creează întâi obiectul ($json.livrare = $json.livrare ?? {}) sau scrie tot obiectul dintr-o dată.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul e perechea lui Cannot read properties of undefined, dar la scriere: (setting 'oras') înseamnă că ai încercat ceva.oras = ..., iar ceva este undefined. JavaScript nu creează automat obiectele intermediare: $json.livrare.oras = 'Cluj' merge doar dacă $json.livrare există deja.
În n8n apare când completezi date imbricate în Code: adrese, setări, câmpuri de răspuns pentru un API. Dacă unele item-uri au deja obiectul și altele nu, eroarea apare doar la unele item-uri (Code arată linia și, în modul Each Item, item-ul).
Reparația: creează obiectul înainte ($json.livrare ??= {} sau $json.livrare = $json.livrare || {}) ori construiește-l complet: $json.livrare = { oras: 'Cluj', judet: 'CJ' }. În Edit Fields, opțiunea Support Dot Notation creează automat structura pentru un câmp numit livrare.oras.
De ce apare: cauzele frecvente
1Câmp scris într-un obiect inexistent
$json.livrare.oras = $json.oras;$json.livrare = $json.livrare ?? {};
$json.livrare.oras = $json.oras;?? păstrează obiectul existent sau creează unul gol, apoi scrierea câmpului merge.
2Construiește obiectul complet
$json.livrare.oras = $json.oras;
$json.livrare.curier = 'Fan';$json.livrare = { oras: $json.oras, curier: 'Fan' };Un singur obiect nou, scris dintr-o dată, nu depinde de ce exista înainte.
3Fără Code: Edit Fields cu notația cu punct
Code doar pentru un câmp imbricatEdit Fields: nume câmp livrare.oras, opțiunea Support Dot Notation activăEdit Fields creează singur obiectul livrare când notația cu punct e activă.
Repară eroarea, direct în pagină
Nodul Livrare (Code, Each Item) se oprește cu „Cannot set properties of undefined (setting 'oras')”, pentru că comanda 5003 nu are obiectul livrare. Repară codul ca fiecare comandă să aibă livrare.oras = orașul clientului (câmpul oras), păstrând curierul existent acolo unde există, și rulează.
Indiciu
Creează obiectul livrare dacă lipsește, înainte să scrii în el.
Reparația
În Livrare:
$json.livrare = $json.livrare ?? {};
$json.livrare.oras = $json.oras;
return $input.item;De ce merge
Comanda 5003 nu are livrare, deci $json.livrare e undefined, iar scrierea .oras în el aruncă eroarea. $json.livrare = $json.livrare ?? {} păstrează obiectul existent (cu curierul) acolo unde există și creează unul gol unde lipsește. Apoi oras se poate scrie la toate comenzile.
Alte forme ale mesajului
TypeError: Cannot set properties of undefined (setting 'oras')Cannot set property 'oras' of undefinedCannot set properties of null (setting 'oras')
Cum o eviți pe viitor
- Înainte să scrii
a.b.c = x, asigură-te căa.bexistă (a.b ??= {}). - Preferă construirea obiectelor complete în loc de completarea lor câmp cu câmp.
- Pentru câmpuri imbricate simple folosește Edit Fields cu Support Dot Notation.
- Testează cu item-uri care nu au deloc obiectul imbricat.
Întrebări frecvente
De ce eroarea apare doar la unele item-uri?
Pentru că unele au deja obiectul (livrare: {...}), iar la ele scrierea merge. Doar item-urile fără obiect dau eroarea.
Ce face ??= ?
a ??= b atribuie b doar dacă a este null sau undefined. E prescurtarea pentru a = a ?? b.
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. Unknown top-level item key: total Codul returnează un item cu un câmp pus lângă json, nu înăuntrul lui, de exemplu { json: {...}, total: 5 }. La nivelul de sus, un item poate avea doar json, binary, pairedItem și câteva chei speciale. Mută câmpul în json: { json: { ...date, total: 5 } }. Code doesn't return a single object Nodul Code e în modul Run Once for Each Item, unde codul rulează o dată pentru fiecare item și trebuie să returneze un singur obiect, nu o listă. Scoate parantezele pătrate din return ({ json: {...} }) sau, dacă vrei să produci mai multe item-uri, treci pe modul Run Once for All Items. Î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.
