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

Cannot read properties of null (reading 'oras')

Pe scurt

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

Greșit
JSON
{{ $json.adresa.oras }}
Corect
JSON
{{ $json.adresa?.oras ?? 'necunoscut' }}

?. nu mai citește mai departe dacă adresa e null.

2Lanț lung

Greșit
JSON
{{ $json.livrare.curier.nume }}
Corect
JSON
{{ $json.livrare?.curier?.nume ?? 'fără curier' }}

Fiecare nivel poate lipsi.

3|| vs ??

Greșit
JSON
{{ $json.reducere || 10 }}   (reducere 0 devine 10)
Corect
JSON
{{ $json.reducere ?? 10 }}

?? înlocuiește doar null și undefined, nu și 0.

Repară tu

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

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

← 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.