Minifikator formatu JSON

Co jest usuwane

• Białe znaki między tokenami: spacje, tabulatory oraz znaki nowej linii.
• Komentarze (w stylu JSONC: // i /* */), usuwane, ponieważ ścisły JSON ich zabrania.
• BOM oraz początkowe białe znaki na początku dokumentu.

Co nie jest usuwane

• Wartości: każdy ciąg znaków, liczba, wartość logiczna oraz null są zachowywane dokładnie.
• Format liczb: każda liczba zostaje zachowana dokładnie tak, jak została zapisana: 1.50 pozostaje 1.50, a 1e-3 pozostaje 1e-3. Narzędzie zachowuje wprowadzoną dokładność.
• Kolejność kluczy: obiekty zachowują swoją pierwotną kolejność wstawiania.

Dlaczego minifikować JSON

– Mniejsze payloady: sformatowana konfiguracja o wielkości 120 KB może skurczyć się do 70 KB, to ma znaczenie przy każdym żądaniu. – Wstawki inline: gdy umieszczasz JSON w tagu <script> lub w parametrze URL, białe znaki to zmarnowane pasmo. – Stabilność skrótu (hash): dwa semantycznie równoważne dokumenty JSON różniące się jedynie białymi znakami dają różne wartości skrótu. Wcześniejsza minifikacja zapewnia spójny skrót (choć prawdziwa kanonizacja sortuje też klucze).

Referencja do oszczędzenia bajtów

Po użyciu gzip różnica znacząco maleje, gzip już skutecznie kompresuje białe znaki. W przypadku surowych bajtów (adresy URL, wstawki inline) minifikuj; w przypadku transmisji przez sieć polegaj na gzip.

Gdy nie należy minimalizować

– Pliki konfiguracji przechowywane w systemie kontroli wersji – czytelność ma priorytet nad ilością bajtów. – Pliki edytowane przez użytkowników – nikt nie edytuje uproszczonego formatu JSON ręcznie, nie żałując tego decyzji. – Artefakty debugowe – pojedynczy plik JSON o wielkości 400 KB zawarty w protokole awarii jest niemożliwy do odczytania.

Najczęstsze błędy

– Minifikacja danych JSON zależnych od komentarzy: Komentarze są usuwane, a zachowanie parsera może się zmienić w przypadku obecności znaczników typu „TODO“. – Minifikacja liczb zmiennoprzecinkowych: Niektóre narzędzia ponownie serializują 0.1 inaczej niż w danych wejściowych; to narzędzie zachowuje reprezentację tekstową dokładnie taką, jaka jest. – Używanie minifikacji jako kompresji: Gzip oszczędza więcej bajtów niż minifikacja w przypadku tekstu. Połącz obie metody, nie zastępuj jednej drugą.