Formatare JSON

Ce este JSON?

JSON (JavaScript Object Notation) este un format ușor de schimb de date, ușor de citit și scris de oameni și ușor de parsat și generat de mașini. În ciuda numelui său, JSON este independent de limbaj și este folosit practic de fiecare limbaj de programare modern, API și sistem de baze de date.

JSON acceptă șase tipuri de date: șiruri (între ghilimele duble), numere, valori booleene (true/false), null, obiecte (perechi cheie-valoare între acolade) și tablouri (liste ordonate între paranteze drepte). Simplitatea și universalitatea sa l-au făcut formatul dominant pentru API-urile web, fișierele de configurare și stocarea datelor.

Cum se formatează JSON

Lipiți JSON-ul în zona de intrare. Formatorul validează sintaxa, detectează erorile și produce ieșire corect indentată. Dacă JSON-ul este invalid, locația exactă a erorii este evidențiată pentru a-l putea corecta rapid. Puteți comuta între ieșire formatată (lizibilă) și minificată (compactă).

Ce face formatorul JSON?

• Validează sintaxa JSON și raportează locația exactă a erorilor.
• Formatează ieșirea cu indentare și întreruperi de linie consistente.
• Minifică JSON eliminând toate spațiile inutile pentru un fișier mai mic.

Erori frecvente în JSON

• Virgule finale după ultimul element dintr-un obiect sau tablou — JSON nu permite virgule finale, spre deosebire de JavaScript.
• Ghilimele simple în loc de duble — JSON necesită ghilimele duble pentru toate cheile și valorile de tip șir.
• Nume de proprietăți fără ghilimele — fiecare cheie trebuie să fie un șir cu ghilimele duble.
• Virgule lipsă între perechile cheie-valoare sau elementele tabloului.
• Comentarii în JSON — specificația JSON nu acceptă comentarii de niciun fel.

Lucrul eficient cu JSON

La depanarea răspunsurilor API, formatați mai întâi JSON-ul pentru a face structura vizibilă. Obiectele profund imbricate sunt mult mai ușor de navigat cu indentare corespunzătoare. Pentru fișierele de configurare, luați în considerare JSON5 sau JSONC (JSON cu comentarii) dacă instrumentele dumneavoastră le acceptă.

Pentru fișiere JSON mari (peste 1 MB), folosiți parsere în flux în loc să încărcați întregul document în memorie. Instrumente precum jq (linie de comandă) sau căutătoarele de cale JSON online pot extrage valori specifice din structuri complexe fără a reformata întregul document.

JSON vs. alte formate

Față de XML, JSON este mai concis și mai ușor de parsat. Față de YAML, JSON este mai strict și mai puțin predispus la erori de indentare. Față de CSV, JSON gestionează natural datele imbricate și ierarhice. Fiecare format are punctele sale forte, dar echilibrul JSON dintre simplitate și expresivitate îl face alegerea implicită pentru API-urile web.

JSON-ul meu este securizat?

Da. Toată procesarea are loc în browserul dumneavoastră folosind funcția JSON.parse() integrată în JavaScript. Datele nu sunt niciodată trimise pe server. Puteți formata în siguranță fișiere de configurare sensibile, chei API și date private.

Întrebări frecvente

Care este dimensiunea maximă a unui fișier JSON?

Specificația JSON nu definește o limită de dimensiune. Limitele practice depind de parser și memoria disponibilă. Majoritatea API-urilor web gestionează fără probleme payload-uri JSON de până la 10–100 MB. Acest instrument bazat pe browser funcționează bine cu fișiere de câteva megaocteți.

Poate JSON să conțină funcții sau date?

Nu. JSON acceptă doar șiruri, numere, valori booleene, null, obiecte și tablouri. Funcțiile nu sunt valori JSON valide. Datele calendaristice trebuie reprezentate ca șiruri (de obicei în format ISO 8601, cum ar fi '2024-01-15T10:30:00Z