...
Eroare Linux · Prelucrare de text și căutare: sed și find

jq: error: nume/0 is not defined at <top-level>, line 1:

Pe scurt

jq a citit nume ca pe numele unei funcții, nu al unui câmp, pentru că lipsește punctul din față. Câmpurile se scriu cu punct: .nume, .oras, .[] | .nume. Uneori punctul s-a pierdut din cauza ghilimelelor din bash.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În limbajul lui jq, un cuvânt simplu (nume, length, keys) e un apel de funcție. nume/0 înseamnă „funcția nume cu 0 argumente”, iar jq îți spune că nu există așa ceva (is not defined). <top-level>, line 1 arată că greșeala e în filtrul tău, pe prima linie. Codul de ieșire e 3 (eroare de compilare a filtrului), deci jq nu a citit nici măcar datele.

Cauza obișnuită: ai uitat punctul (nume în loc de .nume), ai scris un șir fără ghilimele (select(.oras == Cluj) caută funcția Cluj), sau ai pus filtrul între ghilimele duble și bash a stricat ceva din el. Funcții reale: length, keys, map, select, sort_by.

De ce apare: cauzele frecvente

1Lipsește punctul din fața câmpului

Greșit
BASH
jq -r '.[] | nume' clienti.json
Corect
BASH
jq -r '.[] | .nume' clienti.json

.nume înseamnă câmpul nume al obiectului curent. Fără punct, jq caută o funcție.

2Șir fără ghilimele

Greșit
BASH
jq '.[] | select(.oras == Cluj)' clienti.json
Corect
BASH
jq '.[] | select(.oras == "Cluj")' clienti.json

Valorile text se scriu între ghilimele duble în jq, altfel sunt luate drept funcții.

3Variabila bash pusă direct în filtru

Greșit
BASH
jq ".[] | select(.oras == $oras)" clienti.json
Corect
BASH
jq --arg oras "$oras" '.[] | select(.oras == $oras)' clienti.json

--arg trimite valoarea ca șir jq, fără probleme de ghilimele.

Repară tu

Repară eroarea, direct în pagină

Scriptul nume.sh trebuie să afișeze numele tuturor clienților din clienti.json, câte unul pe linie. Rulat, dă jq: error: nume/0 is not defined at <top-level>, line 1:. Repară filtrul jq ca scriptul să afișeze Ana și Dan.

Indiciu

Câmpurile unui obiect se scriu în jq cu un anumit caracter în față.

Alte forme ale mesajului

  • jq: error: Cluj/0 is not defined at <top-level>, line 1:
  • jq: error: titlu/0 is not defined at <top-level>, line 1:
  • jq: 1 compile error
  • jq: error: $oras is not defined at <top-level>, line 1:

Cum o eviți pe viitor

  • Pune filtrul jq mereu între apostrofuri.
  • Câmpurile au punct în față, textele au ghilimele duble.
  • Valorile din bash le dai prin --arg nume valoare (text) sau --argjson.
  • Construiește filtrul pas cu pas: jq '.', apoi jq '.[]', apoi jq '.[] | .nume'.

Întrebări frecvente

Ce înseamnă /0 din mesaj?

Numărul de argumente ale funcției căutate. jq permite funcții cu același nume și număr diferit de argumente, deci le identifică așa: nume/0, map/1.

De ce codul de ieșire e 3?

jq folosește 2 pentru erori de utilizare sau de date și 3 pentru erori de compilare a filtrului, adică exact cazul ăsta.

Erori înrudite

← Toate erorile Linux

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ță Linux de la zero, cu exerciții la fiecare lecție

Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.