Sari la conținut
🛠️
Whiz Tools

Formator JSON: Minimizare și Formatare JSON Online Gratuit

Formator JSON gratuit pentru minimizarea și formatarea JSON instantaneu. Comprimă JSON, validează sintaxa și afișează frumos cu indentare corespunzătoare. Instrument rapid și sigur bazat pe browser.

Formator JSON

Calculator de încărcare...
📚

Documentație

Formatar JSON: minimizarea și înfrumusețarea JSON

Un formator JSON este un instrument care rescrie textul JSON într-un alt format, fără să modifice datele din interior. Acest formator JSON face două lucruri: minimizează JSON eliminând spațiile albe suplimentare și îl înfrumusețează adăugând indentare și întreruperi de linie, pentru a putea fi citit de oameni.

Ce este JSON?

JSON, prescurtare de la JavaScript Object Notation, este un format text pentru stocarea și transmiterea datelor. Serverele web îl folosesc pentru a trimite informații aplicațiilor și browserelor. Programele îl folosesc pentru fișierele de setări. Acesta stochează datele sub formă de obiecte, scrise între acolade {}, și de tablouri, scrise între paranteze drepte []. Într-un obiect, fiecare element de date are un nume, numit cheie, și o valoare. O valoare poate fi un șir de caractere, un număr, true, false, null sau un alt obiect ori tablou.

Un obiect JSON mic arată astfel:

1{
2  "name": "John Doe",
3  "age": 30,
4  "isEmployee": true
5}
6

Cum funcționează acest formator JSON

Unele instrumente JSON citesc textul într-o structură de date proprie unui limbaj de programare și apoi scriu structura respectivă din nou sub formă de text. Această conversie dus-întors poate modifica datele. Poate rescrie numere foarte mari, poate elimina numerele prea mari pentru a fi reprezentate și poate reordona cheile dintr-un obiect.

Acest instrument evită acest lucru. Citește datele de intrare caracter cu caracter și verifică dacă respectă gramatica JSON. Când rescrie rezultatul, copiază fiecare număr și fiecare șir exact așa cum au fost introduse, în aceeași ordine. Minimizarea sau înfrumusețarea unui document nu modifică niciodată un număr, o cheie, ordinea cheilor sau o cheie duplicată.

Dacă textul nu este JSON valid, instrumentul se oprește și afișează o eroare, în loc să ghicească ce s-a intenționat.

Formatarea are loc în browser. Instrumentul nu trimite textul lipit către un server. Datele de intrare sunt adăugate la adresa web a paginii ca parametru de interogare, astfel încât un document formatat poate fi partajat sau salvat ca favorit printr-un link.

Cum se minimizează JSON

  1. Lipește JSON în caseta de introducere.
  2. Fă clic pe „Minimizează”.
  3. Instrumentul elimină spațiile, caracterele de tabulare și întreruperile de linie dintre tokenuri și afișează rezultatul mai jos.
  4. Fă clic pe „Copiază”, deasupra rezultatului, pentru a-l copia.

Exemplu rezolvat

Înainte:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

După:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Formula minimizării JSON

Spațiul economisit prin minimizare poate fi exprimat astfel:

Spațiu economisit=(1−dimensiunea minimizata˘dimensiunea inițiala˘)×100%\text{Spațiu economisit} = \left(1 - \frac{\text{dimensiunea minimizată}}{\text{dimensiunea inițială}}\right) \times 100\%

Pentru exemplul de mai sus, versiunea formatată are 98 octeți, iar versiunea minimizată are 67 octeți:

(1−6798)×100%≈32%\left(1 - \frac{67}{98}\right) \times 100\% \approx 32\%

Economia exactă depinde de cantitatea de spații albe și de indentare din documentul inițial. Un document cu imbricare profundă și indentare de 4 spații se micșorează mai mult decât unul care era deja compact.

Cum se înfrumusețează JSON

  1. Lipește JSON în caseta de introducere. Acesta poate fi deja minimizat sau formatat neordonat.
  2. Fă clic pe „Înfrumusețează”.
  3. Instrumentul adaugă o indentare de 2 spații, câte o întrerupere de linie pentru fiecare cheie sau element de tablou și un spațiu după fiecare două puncte.
  4. Fă clic pe „Copiază”, deasupra rezultatului, pentru a-l copia.

Exemplu rezolvat

Înainte:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

După:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Un obiect sau un tablou gol rămâne pe o singură linie, ca {} sau [], în loc să fie împărțit pe trei linii.

Erori JSON frecvente detectate de acest instrument

JSON are o gramatică strictă, mai strictă decât cea a unui limbaj de programare obișnuit. Acest instrument respinge textele care încalcă oricare dintre următoarele reguli și afișează mesajul „JSON nevalid” în locul unui rezultat:

  • O virgulă lipsă între două valori.
  • O virgulă finală după ultimul element al unui obiect sau tablou (nepermisă în JSON, spre deosebire de JavaScript).
  • O cheie care nu este încadrată între ghilimele duble.
  • Ghilimele simple în jurul unui șir, în locul ghilimelelor duble.
  • Paranteze drepte și acolade care nu corespund sau lipsesc.
  • O secvență de escape nevalidă sau incompletă în interiorul unui șir, cum ar fi o bară oblică inversă singură.
  • Un caracter de control, cum ar fi o linie nouă efectivă sau un caracter de tabulare, introdus într-un șir în loc să fie scris ca \n sau \t.
  • Un număr într-o formă pe care JSON nu o permite, cum ar fi un zero inițial (01), un punct zecimal final (1.) sau un plus inițial (+1).

JSON nu are nici sintaxă pentru comentarii. Textul care începe cu // sau /* nu face parte din gramatica JSON, astfel că lipirea unui JSON care conține comentarii produce o eroare „JSON nevalid”, nu un JSON din care comentariile au fost eliminate în mod discret. Pentru a formata un astfel de fișier, elimină mai întâi comentariile.

Cazuri de utilizare pentru formatorul JSON

  • Dezvoltare web: citirea răspunsurilor API în timpul depanării și minimizarea fișierelor de configurare înainte de implementare.
  • Dezvoltarea API-urilor: verificarea faptului că un corp de cerere sau de răspuns este JSON bine format.
  • Analiza datelor: transformarea unui export JSON compact într-un aspect ușor de citit pentru examinare.
  • Fișiere de configurare: înfrumusețarea unui fișier de configurare înainte de editarea manuală, apoi minimizarea lui din nou.

Alternative

Editoare de cod precum Visual Studio Code pot formata fișiere JSON fără a părăsi editorul. Instrumente de linie de comandă precum jq pot formata și filtra JSON ca parte a unui script. Și limbajele de programare includ biblioteci JSON, precum modulul json din Python sau obiectul încorporat JSON din JavaScript, pe care majoritatea programelor îl folosesc pentru a analiza JSON și a-l transforma în propriile structuri de date. Un formator online ca acesta este util când este necesară o verificare rapidă, punctuală, fără instalarea vreunui program.

Istoricul JSON

Douglas Crockford a specificat JSON la începutul anilor 2000, bazându-se pe modul în care JavaScript scrie literalii de obiect, dar proiectându-l astfel încât să poată fi citit și scris de orice limbaj de programare. Formatul a fost documentat public pentru prima dată în jurul anului 2001 și ulterior standardizat ca RFC 4627 în (11.800 cm) 2006, ca ECMA-404 în 2013 și ca RFC 8259 în 2017. Pe măsură ce API-urile web s-au dezvoltat în anii 2000, JSON a înlocuit XML ca formatul cel mai utilizat pentru trimiterea datelor între servere și browsere, în principal deoarece este mai scurt și corespunde direct structurilor de date deja integrate în JavaScript. Instrumentele de formatare și validare au apărut ulterior, pe măsură ce documentele JSON au devenit mai mari și mai imbricate.

Întrebări frecvente

Minimizarea elimină comentariile din JSON? Nu. JSON nu are sintaxă pentru comentarii, iar acest instrument nu adaugă una. Dacă datele de intrare conțin comentarii de tipul // sau /*, instrumentul raportează o eroare „JSON nevalid” în loc să le formateze. Elimină comentariile înainte de a lipi textul.

Formatarea modifică numerele sau ordinea cheilor? Nu. Instrumentul copiază fiecare număr și șir exact așa cum au fost scrise și păstrează cheile în ordinea inițială, inclusiv cheile duplicate, dacă există.

Ce indentare folosește formatorul? Câte două spații pentru fiecare nivel de imbricare, cu un spațiu după fiecare două puncte.

Datele mele JSON sunt trimise către un server? Nu. Formatarea se execută în browser. Textul lipit este copiat în adresa URL a paginii, ca parametru de interogare json, astfel încât pagina să poată fi partajată sau salvată ca favorit. Nimic nu este încărcat.

Există o limită de dimensiune? Nu există o limită fixă, dar întregul document este păstrat în memorie cât timp este analizat, astfel că un fișier foarte mare (de mai mulți megabaiți) poate fi procesat lent pe un dispozitiv mai vechi.

JSON nevalid va fi reparat doar parțial? Nu. Dacă datele de intrare încalcă gramatica JSON oriunde, instrumentul afișează o eroare în loc să returneze un rezultat parțial sau presupus.

Referințe

  1. "Introducing JSON." JSON.org, https://www.json.org/json-en.html.
  2. Bray, T., ed. "The JavaScript Object Notation (JSON) Data Interchange Format." RFC 8259, IETF, decembrie 2017, https://www.rfc-editor.org/rfc/rfc8259.
  3. "ECMA-404: The JSON Data Interchange Syntax." Ecma International, https://www.ecma-international.org/publications-and-standards/standards/ecma-404/.
  4. "JSON." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON.