Formater JSON

Rola formatu JSON w wymianie danych i komunikacji API

Format JSON (JavaScript Object Notation) jest standardem wymiany danych w nowoczesnych aplikacjach internetowych oraz systemach API. Jego czytelność dla człowieka oraz łatwość przetwarzania przez maszyny sprawiają, że jest powszechnie stosowany do przesyłania informacji między serwerem a przeglądarką. Jednak surowe dane generowane przez systemy komputerowe są często pozbawione wcięć i znaków nowej linii, co utrudnia ich analizę.

Narzędzie Formater JSON pozwala na szybkie przekształcenie nieczytelnego bloku tekstu w uporządkowaną strukturę. Umożliwia ono walidację składni, formatowanie z zachowaniem wybranego poziomu wcięć, minifikację kodu oraz analizę drzewa danych bezpośrednio w przeglądarce internetowej.

Wprowadzanie danych i obsługa plików

Narzędzie obsługuje kilka metod wprowadzania danych JSON:

• Wklejanie tekstu: Dane można wprowadzić bezpośrednio do obszaru edytora.
• Wczytywanie plików: Narzędzie pozwala otworzyć pliki z rozszerzeniem .json lub .txt za pomocą przycisku "Otwórz plik" lub poprzez przeciągnięcie i upuszczenie pliku w wyznaczony obszar.

Podczas pracy z plikami obowiązują określone reguły techniczne i ograniczenia:

• Kodowanie: Pliki muszą być zapisane w kodowaniu UTF-8. W przypadku wykrycia innego kodowania wyświetlany jest komunikat: "Ten plik nie jest tekstem w kodowaniu UTF-8, więc nie można go tutaj otworzyć.".
• Rozmiar i limity: Maksymalny rozmiar danych wejściowych wynosi 10 MiB. Przekroczenie tej wartości skutkuje komunikatem: "Dane wejściowe są większe niż {limit}, czyli więcej, niż to narzędzie może przetworzyć.". Dla plików przekraczających limit narzędzie wyświetla: "Plik jest za duży — limit to {limit}.".
• Typ pliku: Próba wczytania pliku o innym rozszerzeniu niż obsługiwane wywołuje błąd: "Nieobsługiwany typ pliku — wybierz plik.json lub.txt.".
• Błędy odczytu: Jeśli wystąpi problem z dostępem do pliku, użytkownik zobaczy komunikat: "Nie udało się odczytać tego pliku. Spróbuj wybrać go ponownie.".

W przypadku bardzo złożonych dokumentów, gdy proces weryfikacji przekroczy bezpieczny czas, działanie zostaje przerwane komunikatem: "Sprawdzanie tego JSON trwało zbyt długo i zostało przerwane. Spróbuj z mniejszym dokumentem.". Próg synchronizacji przetwarzania wynosi 250 000 znaków.

Formatowanie i minifikacja kodu JSON

Głównym zadaniem narzędzia jest zmiana reprezentacji tekstowej dokumentu JSON w zależności od potrzeb użytkownika.

Formatowanie (Pretty Print)

Proces ten polega na dodaniu odpowiednich wcięć i znaków nowej linii, co pozwala na szybkie zrozumienie hierarchii danych. Użytkownik może wybrać preferowany poziom wcięć. Narzędzie pozwala także na wybór składni między standardowym "JSON" a "JSONC" (JSON z komentarzami). Po pomyślnym sformatowaniu pojawia się komunikat "Sformatowano JSON.".

Minifikacja

Minifikacja polega na usunięciu wszystkich zbędnych znaków, takich jak spacje, tabulatory i znaki przejścia do nowej linii, przy jednoczesnym zachowaniu pełnej poprawności struktury danych. Jest to technika stosowana w celu zmniejszenia rozmiaru danych przesyłanych przez sieć lub przechowywanych w bazach danych. Po zakończeniu operacji wyświetlany jest komunikat "Zminimalizowano JSON.".

Narzędzie gwarantuje, że podczas formatowania i minifikacji duże liczby całkowite są zachowywane bez utraty precyzji. Dodatkowo użytkownik ma do dyspozycji statystyki określające parametry wejściowe: "Znaki", "Linie" oraz "Rozmiar".

Nawigacja i analiza struktury w widoku drzewa

Poza standardowym widokiem tekstowym ("Kod"), narzędzie oferuje interaktywny widok strukturalny ("Drzewo"). Pozwala on na wygodne przeglądanie hierarchii obiektów i tablic.

W widoku drzewa dostępne są następujące funkcje i ograniczenia:

• Wyszukiwanie: Pole "Szukaj kluczy i wartości" pozwala lokalizować elementy. Wyniki są indeksowane i wyświetlane w formacie "{current} z {total}" lub "{current} z {total}+" przy dużej liczbie dopasowań. W przypadku braku wyników pojawia się komunikat "Brak dopasowań". Do nawigacji służą przyciski "Poprzednie dopasowanie" i "Następne dopasowanie".
• Zarządzanie węzłami: Użytkownik może korzystać z opcji "Rozwiń wszystko" oraz "Zwiń wszystko". Dla pojedynczych węzłów dostępne są przyciski "Rozwiń {key}" oraz "Zwiń {key}".
• Ograniczenia wydajnościowe: Jeśli dane są zbyt duże, widok drzewa wyświetli komunikat: "Ten kod JSON jest zbyt duży, aby wyświetlić go jako drzewo." lub "Ten JSON zawiera zbyt wiele wartości, aby wyświetlić go jako drzewo.". Przy próbie pełnego rozwinięcia dużego drzewa następuje ograniczenie widoku do określonej liczby wierszy z komunikatem: "Ten JSON jest za duży, aby rozwinąć go w całości — wyświetlanych jest pierwszych {count} wierszy." oraz przyciskiem "Pokaż kolejne {count}…".
• Wymóg poprawności: Widok drzewa nie uruchomi się, jeśli dane wejściowe zawierają błędy składniowe. W takim przypadku wyświetlany jest komunikat: "Popraw błędy w kodzie JSON, aby wyświetlić go w strukturze drzewa.".

Identyfikacja i naprawa błędów składniowych

Narzędzie pełni funkcję walidatora, który precyzyjnie wskazuje miejsce wystąpienia błędu za pomocą współrzędnych: "wiersz {line}, kolumna {col}" oraz przycisku "Przejdź do błędu".

W przeciwieństwie do niektórych parserów, które automatycznie scalają powtarzające się właściwości, to narzędzie traktuje zduplikowane klucze jako błąd, wyświetlając komunikat: "Zduplikowany klucz {key} — usuń jeden przed formatowaniem".

Do najczęstszych wykrywanych błędów należą:

• "Brak przecinka między elementami"
• "Nadmiarowy przecinek przed nawiasem zamykającym"
• "Klucze obiektu muszą być ujęte w podwójne cudzysłowy"
• "Brak dwukropka po nazwie właściwości"
• "W łańcuchu znaków brakuje zamykającego cudzysłowu"
• "JSON kończy się zbyt wcześnie — wygląda na ucięty"
• "Nieoczekiwany znak w miejscu, w którym powinna być wartość"
• "Ten JSON jest zagnieżdżony zbyt głęboko, aby go przetworzyć"

Automatyczna naprawa i obsługa formatów niekompatybilnych

Narzędzie potrafi wykryć i naprawić specyficzne, nieformalne odmiany zapisu danych. Kliknięcie przycisku "Podgląd poprawki" otwiera okno "Podgląd poprawki" z podziałem na sekcje "Oryginał" i "Po poprawce". Jeśli poprawka dotyczy całego dokumentu, wyświetla się informacja: "Podgląd skrócony — poprawka dotyczy całego dokumentu.". Po zatwierdzeniu zmian przyciskiem "Zastosuj poprawkę" pojawia się komunikat: "Poprawka zastosowana. Naciśnij Ctrl/Cmd+Z, aby cofnąć.". W przypadku niepowodzenia wyświetla się: "Nie udało się automatycznie naprawić tych danych.".

Wykrywane formaty oraz powiązane z nimi akcje naprawcze przedstawia poniższa tabela:

Dla innych, niestandardowych błędów stosowany jest ogólny komunikat akcji: "Po zastosowaniu dane wejściowe zostaną zastąpione naprawionym JSON-em.".

Ekstrakcja danych za pomocą JSON Pointer i JSONPath

Podczas pracy z rozbudowanymi strukturami danych w widoku drzewa, użytkownik może kliknąć prawym przyciskiem myszy lub otworzyć menu "Opcje kopiowania dla {key}" dla wybranego węzła (gdzie główny element struktury oznaczony jest jako "korzeń"). Dostępne są tam trzy opcje eksportu:

1. Kopiuj wartość: Kopiuje do schowka bezpośrednią wartość przypisaną do klucza.
2. Kopiuj JSON Pointer: Generuje i kopiuje ścieżkę dostępu zgodną ze standardem RFC 6901 (np. /uzytkownicy/0/imie).
3. Kopiuj JSONPath: Generuje i kopiuje ścieżkę zapisaną w notacji JSONPath (np. $.uzytkownicy.imie).

Po pomyślnym skopiowaniu danych pojawia się komunikat "Skopiowano do schowka.".

Sortowanie kluczy obiektów

Narzędzie udostępnia funkcję "Sortuj klucze". Jej działanie polega na rekurencyjnym sortowaniu kluczy wszystkich obiektów w dokumencie według punktów kodowych Unicode. Kolejność elementów wewnątrz tablic (szablonów indeksowanych numerycznie) pozostaje nienaruszona.

Po wykonaniu tej operacji wyświetlany jest komunikat: "Klucze posortowane — kolejność tablic bez zmian. Naciśnij Ctrl/Cmd+Z, aby cofnąć.".

Bezpieczeństwo i prywatność danych

Przetwarzanie danych wprowadzanych do narzędzia odbywa się lokalnie. Twój kod JSON jest przetwarzany bezpośrednio w przeglądarce i nic nie jest przesyłane do BroBroGo. Dzięki temu dane nie opuszczają urządzenia użytkownika podczas wykonywania operacji formatowania, walidacji czy naprawy.

---

Najczęściej zadawane pytania (FAQ)

Czy mój kod JSON jest gdzieś przesyłany?

Nie. Formater działa w całości w przeglądarce internetowej i nie przesyła Twoich danych JSON na żadne serwery.

Co robi funkcja minifikacji?

Minifikacja usuwa zbędne spacje, tabulatory i znaki nowej linii, zachowując nienaruszoną strukturę danych JSON.

Dlaczego widok drzewa nie chce się załadować?

Widok drzewa wymaga całkowicie poprawnej składni JSON. Jeśli w kodzie występują błędy, należy najpierw skorzystać z funkcji walidacji lub automatycznej naprawy. Widok drzewa nie zostanie również wygenerowany, jeśli dokument przekracza limity rozmiaru lub liczby węzłów.

Jak cofnąć automatyczne sortowanie kluczy lub nałożoną poprawkę?

Zarówno po sortowaniu kluczy, jak i po zastosowaniu automatycznej naprawy, można łatwo przywrócić poprzedni stan dokumentu, używając standardowego skrótu klawiszowego Ctrl+Z (lub Cmd+Z na systemach macOS).