Czym jest formatowanie JSON?
JSON (JavaScript Object Notation) to lekki, tekstowy format wymiany danych zdefiniowany w RFC 8259 i ECMA-404. Dokument JSON jest drzewem składającym się z sześciu typów wartości — object, array, string, number, boolean i null. Formatowanie dodaje białe znaki, aby ludzie mogli czytać to drzewo; minifikacja usuwa białe znaki, aby maszyny mogły szybciej przesyłać je przez sieć.
Jak działa formatowanie JSON?
Twoje dane wejściowe są przetwarzane w całości w przeglądarce przy użyciu wbudowanych funkcji JSON.parse i JSON.stringify. Najważniejsze kroki:
- Dane wejściowe są odczytywane z pola tekstowego, a białe znaki na początku i końcu są usuwane.
- Przeglądarka parsuje je za pomocą
JSON.parse. Jeśli wejście nie jest poprawnym JSON-em, parser zgłaszaSyntaxError, który jest przechwytywany i pokazywany wraz z numerem wiersza i kolumny, w którym się zatrzymał. - Gdy wejście jest poprawne, sparsowana wartość jest ponownie wypisywana za pomocą
JSON.stringify(value, null, indent), gdzieindentto wybrane wcięcie (2 spacje, 4 spacje lub znak tabulacji). - Przy minifikacji
JSON.stringify(value)jest wywoływane bez argumentu wcięcia, co daje najkrótszą poprawną formę tej samej wartości, bez zbędnych białych znaków. - Wynik jest zapisywany w polu tekstowym tylko do odczytu, a panel statusu zgłasza albo Prawidłowy JSON, albo dokładny błąd parsowania, byś mógł od razu poprawić źródło.
Dlaczego formatować JSON tym narzędziem?
- Prywatność: każde parsowanie, formatowanie i minifikacja odbywa się w Twojej przeglądarce. JSON nigdy nie trafia na nasze serwery.
- Natychmiastowa walidacja: źle wstawione przecinki, klucze bez cudzysłowów, pojedyncze apostrofy i przecinki na końcu są zgłaszane z dokładną wskazówką numeru wiersza i kolumny, abyś mógł skoczyć od razu do błędu.
- Wynik gotowy do code review: ładnie wydrukowany JSON ze spójnym wcięciem daje czyste różnice w code review i czytelne pliki konfiguracyjne.
- Minifikacja gotowa do produkcji: usunięcie zbędnych białych znaków pomniejsza ładunki API, pliki manifestu i osadzone fixtury, zanim trafią na produkcję.
Jakie są typowe zastosowania formatowania JSON?
Czytanie i pisanie JSON-a pojawia się w wielu obszarach tworzenia stron i narzędzi:
- Debugowanie API: wklejenie surowej odpowiedzi z
curllub panelu sieci, aby potwierdzić strukturę, znaleźć literówkę w kluczu lub wykryć brakujący nawias zamykający. - Porządkowanie konfiguracji: ponowne wciąganie ręcznie edytowanego
package.json,tsconfig.jsonlub manifestów CI, by przeszły code review i lintery. - Czytanie logów: ponowne formatowanie zwartych linii logu
application/json, aby każde pole było ustawione pod następnym, a następnie ponowna minifikacja przed wklejeniem do zgłoszenia.
Jak wygląda przykład formatowania JSON?
Wklejenie {"id":42,"name":"Ada Lovelace","email":"ada@example.com","roles":["admin","engineer"]} i naciśnięcie FORMATUJ z wcięciem 2 spacji rozkłada to na dziewięć linii, w których każde pole obiektu i każdy element tablicy mają własny wiersz. Naciśnięcie MINIFIKUJ na sformatowanym tekście zwija go bajt w bajt z powrotem do tego samego zwartego ciągu.
Ten formatator JSON parsuje tym samym silnikiem, którego używa Twoje środowisko Node.js, Deno lub przeglądarka, a wynik wkleisz wprost do kodu, konfiguracji lub logów.