JSON Formatter

Επικολλήστε συμπαγές, ελαχιστοποιημένο ή ακατάστατο JSON και λάβετε τέλεια μορφοποιημένη έξοδο αμέσως. Ο μορφοποιητής αναλύει το JSON σας με τη εγγενή συνάρτηση JSON.parse του browser (σύμφωνα με το ECMA-404), διατηρεί τους χαρακτήρες Unicode και το επανεκπέμπει με την εσοχή που έχετε επιλέξει:

• 2 διαστήματα (προεπιλογή για npm και prettier)
• 4 διαστήματα
• tab

Τα ένθετα αντικείμενα και οι πίνακες έχουν σωστή εσοχή σε κάθε βάθος. Τα κλειδιά, τα strings, οι αριθμοί, οι τιμές boolean και το null παίρνουν διακριτικά χρώματα χρωματισμού σύνταξης ώστε να μπορείτε να ελέγξετε τη δομή με μια ματιά.

Η ετικέτα 'beautifier' χρησιμοποιείται εναλλακτικά με το 'formatter' ή το 'pretty printer' — όλα περιγράφουν την ίδια λειτουργία: την παραγωγή JSON αναγνώσιμου από τον άνθρωπο από συμπαγή είσοδο.

Η επικύρωση εκτελείται καθώς πληκτρολογείτε. Εάν το JSON σας αποτύχει στην ανάλυση, ο μορφοποιητής δείχνει την ακριβή γραμμή, στήλη και τι ανέμενε ο αναλυτής.

Η επικύρωση είναι αυστηρή σύμφωνα με το RFC 8259 (το Internet Standard του IETF) και το ECMA-404 — χωρίς σχόλια, χωρίς κόμματα στο τέλος, χωρίς μονά εισαγωγικά, χωρίς κλειδιά χωρίς εισαγωγικά, χωρίς NaN, χωρίς Infinity, χωρίς undefined. Η τιμή ανώτατου επιπέδου μπορεί να είναι οποιαδήποτε τιμή JSON (αντικείμενο, πίνακας, string, αριθμός, true, false, null).

Για είσοδο κωδικοποιημένη σε UTF-8, ο μορφοποιητής αποδέχεται το πλήρες σύνολο χαρακτήρων Unicode· τα περιβάλλοντα μόνο ASCII θα πρέπει να χρησιμοποιούν escapes \uXXXX.

Συνήθη σφάλματα και διορθώσεις:

• κόμμα στο τέλος μετά το τελευταίο στοιχείο πίνακα/αντικειμένου (αφαιρέστε το)
• μονά εισαγωγικά γύρω από κλειδιά ή strings (αντικαταστήστε με διπλά εισαγωγικά)
• απουσία αγκύλης ή παρενθέσης κλεισίματος (η στήλη σφάλματος δείχνει κοντά στην αποκοπή)
• μη διαφεύγοντες χαρακτήρες ελέγχου σε strings (χρησιμοποιήστε \n, \t, \\)

Η ελαχιστοποίηση αφαιρεί όλα τα ασήμαντα λευκά διαστήματα — διαστήματα μεταξύ tokens, εσοχές και αλλαγές γραμμής — αφήνοντας την πιο συμπαγή δυνατή αναπαράσταση. Συνήθως η εξοικονόμηση είναι 20–60% ανάλογα με το πόσο έντονη εσοχή είχε το πηγαίο σας JSON.

Χρησιμοποιήστε ελαχιστοποιημένο JSON για:

• Απαντήσεις API REST/GraphQL
• Μηνύματα WebSocket
• Payloads JWT
• Πακέτα ρυθμίσεων SaaS
• ενσωματωμένα χαρακτηριστικά δεδομένων σε HTML

Διατηρήστε το μορφοποιημένο (pretty-printed) JSON για:

• αρχεία ρύθμισης με έλεγχο έκδοσης
• fixtures και snapshots σε δοκιμές
• έγγραφα επεξεργασμένα από ανθρώπους

Το ελαχιστοποιημένο JSON εξακολουθεί να είναι 100% τυπικό JSON — οποιοσδήποτε συμβατός αναλυτής το αποδέχεται. Ο ελαχιστοποιητής εδώ διατηρεί τα δεδομένα ακριβώς: καμία αναδιάταξη κλειδιών, καμία εξαναγκασμένη τιμή, καμία απώλεια ακρίβειας στους αριθμούς εντός του διπλού εύρους IEEE 754.

Η καθαρή επικύρωση σύνταξης JSON ελέγχει μόνο ότι το έγγραφο αναλύεται. Το JSON Schema επικυρώνει το σχήμα του εγγράφου — ότι το 'email' είναι string, η 'age' είναι ακέραιος 0–150, ο 'role' είναι ένα από τα ['admin', 'user', 'guest']. Ένα σχήμα είναι από μόνον του ένα έγγραφο JSON που περιγράφει τους περιορισμούς· τα στιγμιότυπα επικυρώνονται έναντι αυτού.

Συνήθεις λέξεις-κλειδιά: type, required, properties, items, enum, pattern (regex), minimum/maximum, minLength/maxLength, format (email, date-time, uri).

Υλοποιήσεις αναφοράς:

• Ajv (JavaScript, ταχύτερη)
• jsonschema (Python)
• networknt/json-schema-validator (Java)
• justinrainbow/json-schema (PHP)

Η επικύρωση σχήματος εντοπίζει μια τεράστια κατηγορία σφαλμάτων στα όρια του API: ελλείποντα υποχρεωτικά πεδία, λάθος τύπους, τιμές εκτός εύρους, κακοσχηματισμένες ημερομηνίες. Οι προδιαγραφές OpenAPI 3.x χρησιμοποιούν το JSON Schema για επικύρωση αιτημάτων/απαντήσεων.

Το JSONPath είναι για το JSON ό,τι το XPath είναι για το XML — μια γλώσσα ερωτημάτων για πλοήγηση και εξαγωγή από ένθετο JSON.

Σύνταξη:

• $ (ρίζα)
• . (παιδί)
• .. (αναδρομική κάθοδος)
• [n] (δείκτης πίνακα)
• [start:end] (τεμαχισμός)
• [?(expression)] (φίλτρο)
• * (μπαλαντέρ)

Παραδείγματα σε ένα τυπικό JSON καταστήματος:

• $.store.book[0].title παίρνει τον τίτλο του πρώτου βιβλίου
• $..author επιστρέφει κάθε συγγραφέα σε όλο το έγγραφο
• $.store.book[?(@.price < 10)] φιλτράρει βιβλία φθηνότερα από 10
• $.store..price[*] ισοπεδώνει όλες τις τιμές

Εργαλεία: jq (ελαφρώς διαφορετική σύνταξη αλλά οι ίδιες δυνατότητες, κυρίαρχο στο shell scripting), σενάρια δοκιμών Postman, JMESPath (--query του AWS CLI) και βιβλιοθήκες JSONPath σε κάθε κύρια γλώσσα.

JSON Lines (jsonlines.org), γνωστό και ως NDJSON ή LDJSON, είναι μια μορφή όπου κάθε γραμμή αποτελεί μια πλήρη τιμή JSON. Το αρχείο συνολικά δεν αποτελεί έγκυρο JSON, αλλά κάθε γραμμή ξεχωριστά είναι.

Χρησιμοποιείται ευρέως για ροές αρχείων καταγραφής (Loki, Splunk HEC, Vector), αγωγούς ETL, δεδομένα εκπαίδευσης μηχανικής μάθησης (αρχεία fine-tuning του OpenAI) και οποιαδήποτε ροή δεδομένων μόνο προσθήκης (append-only).

Πλεονεκτήματα:

• κατάλληλο για ροές (υπολογισμός ημερών ανά εγγραφή, σταθερή μνήμη)
• μόνο προσθήκη (απλώς γράψτε την επόμενη γραμμή)
• συμβατό με grep και awk με τυπικά εργαλεία Unix

Εκτεταμένα αρχεία: .jsonl, .ndjson. Μετατροπή από πίνακα JSON με `jq -c '.[]'`. Μετατροπή σε πίνακα JSON με `jq -s` (slurp). Τα BigQuery, Athena, Snowflake και οι περισσότερες σύγχρονες αποθήκες δεδομένων δέχονται το NDJSON εγγενώς.

JSON5 (json5.org) επεκτείνει το JSON με ευκολίες για προγραμματιστές:

• σχόλια (// και /* */)
• κόμματα στο τέλος
• συμβολοσειρές με μονά εισαγωγικά
• κλειδιά χωρίς εισαγωγικά
• πολυγραμμικές συμβολοσειρές (με συνέχιση με ανάποδη κάθετο)
• δεκαεξαδικοί αριθμοί
• ειδικές τιμές IEEE 754 (NaN, Infinity)

ΔΕΝ είναι συμβατό με το JSON.parse — χρειάζεστε έναν αναλυτή JSON5 (πακέτο json5 npm, PyJson5).

Χρησιμοποιήστε το JSON5 για αρχεία ρυθμίσεων που επεξεργάζονται χρήστες, όπου τα σχόλια είναι χρήσιμα: babel.config.json5, ορισμένες ρυθμίσεις εργαλείων δόμησης, .vscode/settings.json (το οποίο χρησιμοποιεί JSONC, μια παρόμοια διάλεκτο JSON με σχόλια).

Προτιμήστε το αυστηρό JSON για: API HTTP, ανταλλαγή δεδομένων, μορφές αποθήκευσης και οτιδήποτε παράγεται από μηχανή. Η ανάμειξη των δύο μπερδεύει τα εργαλεία — επιλέξτε ένα ανά αρχείο και μείνετε σε αυτό.

Τα συχνότερα σφάλματα ανάλυσης JSON και οι διορθώσεις τους:

• (1) Κόμμα στο τέλος μετά το τελευταίο στοιχείο — `{"a":1,}` ή `[1,2,3,]` — αφαιρέστε το περιττό κόμμα.
• (2) Μονά εισαγωγικά σε κλειδιά ή τιμές συμβολοσειράς — `{'name':'Alice'}` — πρέπει να είναι διπλά εισαγωγικά.
• (3) Κλειδιά χωρίς εισαγωγικά — `{name:"Alice"}` — βάλτε τα σε εισαγωγικά.
• (4) Σχόλια που χρησιμοποιούν // ή /* */ — το αυστηρό JSON δεν τα επιτρέπει. Αφαιρέστε τα ή μεταβείτε σε JSON5/JSONC.
• (5) Τιμές JavaScript που δεν υπάρχουν στο JSON — undefined, NaN, Infinity, συναρτήσεις — αντικαταστήστε με null ή αφαιρέστε.
• (6) Ελλιπής είσοδος — ο αναλυτής συνήθως δείχνει τη γραμμή όπου τελείωσε το αναμενόμενο περιεχόμενο.
• (7) Σήμα σειράς byte (BOM) στην αρχή ενός αρχείου UTF-8 — οι περισσότεροι αναλυτές το απορρίπτουν. Αφαιρέστε το με `sed -i '1s/^\xEF\xBB\xBF//'`.
• (8) Τα μεικτά στητήρια (tabs) και κενά δεν χαλούν την ανάλυση αλλά χαλούν τα diffs — επιλέξτε ένα στυλ εσοχής.

Τρεις κατηγορίες ευπαθειών που σχετίζονται με το JSON τις οποίες πρέπει να κατανοεί κάθε προγραμματιστής.

• (1) Μόλυνση πρωτοτύπου: η συγχώνευση μη αξιόπιστου JSON σε ένα υπάρχον αντικείμενο μπορεί να μολύνει το Object.prototype εάν η είσοδος περιέχει κλειδιά __proto__, constructor ή prototype — επηρεάζοντας κάθε αντικείμενο στο περιβάλλον εκτέλεσης. Χρησιμοποιήστε Object.create(null), structuredClone ή βιβλιοθήκες όπως τα defaultsDeep του lodash που αποκλείουν ρητά αυτά τα κλειδιά.
• (2) Μην χρησιμοποιείτε ποτέ eval() για την ανάλυση JSON — η eval εκτελεί οποιαδήποτε JavaScript, ενώ το JSON.parse είναι απομονωμένο σε sandbox. Ο μύθος ότι 'η eval είναι γρηγορότερη' καταρρίφθηκε χρόνια πριν.
• (3) Παγίδες επανασύνθεσης: Το JSON.stringify παραλείπει σιωπηρά τις συναρτήσεις, το undefined και τις τιμές Symbol από τα αντικείμενα (μετατρέπονται σε null στους πίνακες). Επίσης, προκαλεί σφάλμα σε κυκλικές αναφορές και BigInt από προεπιλογή.

Επικυρώστε το μη αξιόπιστο JSON με JSON Schema πριν από την επεξεργασία, ορίστε μέγιστο μέγεθος σώματος στο API σας και χρησιμοποιήστε ελέγχους Content-Type για να απορρίψετε νωρίς τις μη JSON εισόδους. Το φύλλο εξαπάτησης ασφάλειας REST της OWASP καλύπτει ολόκληρη την εικόνα.

JSON ↔ YAML είναι η πιο αμείωτη μετατροπή — και τα δύο υποστηρίζουν ένθετα αντικείμενα/πίνακες. Προσέξτε την αυτόματη μετατροπή τύπων του YAML (τα yes/no/on/off γίνονται boolean, οι αριθμοί χωρίς εισαγωγικά παραμένουν αριθμοί, η κυριολεκτική συμβολοσειρά 'null' γίνεται null) — βάλτε αμφίσημες τιμές σε εισαγωγικά. Εργαλεία: js-yaml (npm), PyYAML, yq.

JSON → CSV απαιτεί ισπέδωση της ένθετης δομής — λειτουργεί καλύτερα για πίνακες επίπεδων αντικειμένων. Επιλέξτε μια στρατηγική για ένθετες τιμές: stringify (εγγραφή ως JSON σε ένα κελί) ή στήλες σημείου με τελεία (`address.city`, `address.zip`). Εργαλεία: in2csv του csvkit, pandas pd.json_normalize, json2csv (npm).

JSON → XML είναι απλό για δομές δέντρου, αλλά χάνει τη διάκριση μεταξύ πίνακα και αντικειμένου — τα αδέλφια XML θα μπορούσαν να είναι οτιδήποτε. Προσέξτε για μη έγκυρα ονόματα στοιχείων XML (δεν μπορούν να ξεκινούν με ψηφία, δεν μπορούν να περιέχουν κενά). Εργαλεία: xml-js, xmltodict (Python).

Για όλες τις μετατροπές, αποφασίστε εκ των προτέρων εάν θα διατηρήσετε τις πληροφορίες τύπου ή θα ισπεδώσετε τα πάντα σε συμβολοσειρές.

JSON.parse φορτώνει ολόκληρο το έγγραφο στη μνήμη — είναι εντάξει για τυπικές απαντήσεις API, αλλά προβληματικό για αρχεία άνω των λίγων εκατοντάδων MB. Οι αναλυτές ροής επεξεργάζονται ένα διακριτικό (ή μία εγγραφή) τη φορά, διατηρώντας σταθερή μνήμη ανεξάρτητα από το μέγεθος του αρχείου.

• JavaScript: stream-json ή oboe.js για ανάλυση στυλ SAX.
• Python: ijson για σταδιακή ανάλυση, ή μετατροπή σε JSON Lines πρώτα και ανάγνωση γραμμή προς γραμμή.
• Java: Jackson Streaming API (JsonParser).
• Shell: το jq επεξεργάζεται JSON ροής μέσω του --stream.

Για αρχεία που δημιουργούνται ως πίνακες εγγραφών JSON, σκεφτείτε να αλλάξετε τον παραγωγό ώστε να εκπέμπει JSON Lines — κάθε καταναλωτής στην αλυσίδα επωφελείται. Όταν πρέπει να χειριστείτε έναν τεράστιο πίνακα JSON στη μνήμη, προτιμήστε την επανάληψη και απόρριψη εγγραφών αντί για τη δημιουργία μιας παράλληλης δομής δεδομένων. Παρακolουθήστε το μέγεθος της σωρού (heap), ορίστε το --max-old-space-size στη Node και κάντε profiling πριν από τη βελτιστοποίηση.

Γρήγορη αναφορά για καθημερινές εργασίες JSON.

• Εσοχή: το prettier και το npm χρησιμοποιούν από προεπιλογή 2 κενά. Επιλέξτε 4 για κώδικα επιχειρηματικού επιπέδου που χρησιμοποιεί ήδη εσοχή 4 κενών σε όλες τις γλώσσες. Τα στητήρια (tabs) είναι έγκυρα αλλά σπάνια στο JSON.
• Ταξινόμηση κλειδιών (για καθαρότερα diffs): JSON.stringify(obj, Object.keys(obj).sort(), 2) για ρηχά αντικείμενα. jq --sort-keys για βαθιά αναδρομή. Python json.dumps(obj, sort_keys=True).
• Σύγκριση (Diff) δύο αρχείων JSON: jq --sort-keys και στα δύο αρχεία, στη συνέχεια εκτελέστε κανονικό diff. Ή χρησιμοποιήστε json-diff (npm), DeepDiff (Python), την ενσωματωμένη σύγκριση ευαισθησίας JSON του VS Code.
• Ακολουθίες διαφυγής σε συμβολοσειρές: \\" (διπλό εισαγωγικό), \\\\ (ανάποδη κάθετος), \\/ (προς τα εμπρός κάθετος, προαιρετικό), \\b (backspace), \\f (form feed), \\n (νέα γραμμή), \\r (επιστροφή κεφαλής), \\t (στητήριο), \\uXXXX (σημείο κώδικα Unicode).
• Αριθμοί: Το JSON επιτρέπει δεκαδικούς και εκθέτες (1.5e3) αλλά όχι προπορευόμενα μηδενικά (το 0123 είναι μη έγκυρο) και καμία τελεία στο τέλος (το 1. είναι μη έγκυρο).
• Οι συμβολοσειρές πρέπει να έχουν διπλά εισαγωγικά — τα μονά εισαγωγικά είναι μόνο για JSON5.