Naprawa JSON

Powiązane Rekomendacje

Czym jest naprawa JSON (JSON Repair)?

Przypadki użycia

• Czyszczenie wyników AI/LLM: konwersja jednym kliknięciem JSON z otoczką Markdown, tekstem objaśniającym i przecinkami końcowymi od ChatGPT/Claude na standardowy JSON
• Debugowanie i rozwiązywanie problemów z API: szybkie uzupełnianie nawiasów i łańcuchów, gdy odpowiedzi API są obcięte przez problemy z bramą lub siecią, w celu zlokalizowania oryginalnej struktury danych
• Literały obiektowe JavaScript skopiowane z konsoli: kompleksowa naprawa pojedynczych cudzysłowów, przecinków końcowych i kluczy bez cudzysłowów
• Czyszczenie plików konfiguracyjnych: usuwanie komentarzy z JSON5/JSONC w celu uzyskania standardowego JSON, gotowego do jednolitego przekazania do usług downstream
• Naprawa danych z logów i schowka: szybka standaryzacja fragmentów JSON zawierających komentarze, specjalne białe znaki lub obcięcia
• Przetwarzanie wstępne przy migracji danych: dodanie kroku naprawy w potoku migracji danych, aby zapobiec blokowaniu całego wsadu ETL przez kilka nieprawidłowych JSON-ów

Jak Używać

1. Wklej JSON z błędami, z otoczką Markdown lub obcięty do lewego pola wejściowego, lub kliknij „Przykład”, aby załadować typowy uszkodzony JSON, lub prześlij plik .json/.txt
2. Narzędzie automatycznie wykryje i naprawi typowe problemy składniowe; w prawym obszarze wyjściowym pojawi się sformatowany standardowy JSON oraz liczba naprawionych problemów każdego typu
3. Jeśli pozostaną czerwone komunikaty o błędach, możesz ręcznie edytować dane wejściowe i ponownie uruchomić naprawę (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Po potwierdzeniu poprawności struktury kliknij „Kopiuj”, aby umieścić naprawiony wynik w schowku, lub „Pobierz”, aby zapisać jako repaired.json do dalszego formatowania, walidacji itp.

Funkcje

• Obsługa 7 typowych błędów składniowych: przecinki końcowe, pojedyncze cudzysłowy, klucze bez cudzysłowów, niezamknięte łańcuchy, komentarze, brakujące nawiasy, otoczki bloków kodu Markdown
• Zoptymalizowane czyszczenie wyników AI: automatyczne usuwanie otoczek ```json i tekstu objaśniającego poza blokami kodu, rozpoznawanie typowych wyników ChatGPT, Claude, Gemini i innych LLM
• Kompatybilność z JSON5/JSONC: parsowanie rozszerzonej składni, w tym komentarzy, luźnych cudzysłowów i specjalnych białych znaków (np. niewidocznych znaków Unicode)
• Inteligentne uzupełnianie obciętego JSON: obsługa obciętych odpowiedzi API i brakujących nawiasów zamykających poprzez automatyczne uzupełnianie brakujących nawiasów i cudzysłowów
• Wizualizacja problemów naprawy: automatyczne zliczanie i wyświetlanie liczby naprawionych problemów każdego typu dla łatwego audytu i ręcznej weryfikacji
• Lokalne przetwarzanie dla prywatności: parsowanie, naprawa i formatowanie odbywają się w całości w przeglądarce, dane wejściowe nie są wysyłane na żaden serwer
• Bezproblemowe przekazanie do formatowania: naprawiony standardowy JSON można jednym kliknięciem przekazać do formatowania JSON, walidacji Schema lub generatora kodu
• Ładowanie plików i przykładów: obsługa przesyłania plików .json/.txt lub ładowania przykładu jednym kliknięciem w celu szybkiej weryfikacji efektów naprawy

Przykłady kodu

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // trailing comma + comment
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Still unrepairable:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // trailing comma + comment
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# Usuwanie przecinków końcowych z obiektów/tablic (opcja awaryjna; NIE obsługuje komentarzy / pojedynczych cudzysłowów)
# W złożonych scenariuszach użyj dedykowanej biblioteki, np. jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Walidacja naprawionego wyniku
jq . clean.json >/dev/null && echo 'JSON is valid'

Często Zadawane Pytania

Rozwiązywanie problemów

Słownik

JSON

JavaScript Object Notation, lekki format wymiany danych oparty na parach klucz-wartość, zdefiniowany w RFC 8259. De facto standard dla REST API, plików konfiguracyjnych i logów.

RFC 8259

Oficjalna specyfikacja JSON wydana przez IETF, definiująca ścisłą składnię prawidłowego JSON — wszystkie klucze muszą być w podwójnych cudzysłowach, tylko ograniczony zestaw znaków w łańcuchach wymaga eskejpowania, komentarze i przecinki końcowe nie są dozwolone.

JSON.parse

Ścisły parser JSON wbudowany w JavaScript i nowoczesne przeglądarki, zgodny z RFC 8259. Przy każdym błędzie składniowym zgłasza SyntaxError i nie może wykonywać naprawy tolerancyjnej.

JSON5

Rozszerzona składnia JSON (niestandardowa), zezwalająca na klucze bez cudzysłowów, łańcuchy w pojedynczych cudzysłowach, komentarze (// i /* */), przecinki końcowe, liczby szesnastkowe itp. Łatwiejsza do ręcznego pisania, ale niekompatybilna z JSON.parse.

JSONC

JSON with Comments, ogólna nazwa używana przez edytory takie jak VS Code dla plików konfiguracyjnych JSON z komentarzami (np. tsconfig.json). W praktyce popularny alias dla JSON5.

Trailing Comma / Przecinek końcowy

Dodatkowy przecinek po ostatnim elemencie obiektu lub tablicy. Dozwolony w JavaScript, ale zabroniony przez standard JSON — najczęstszy błąd składniowy w wynikach LLM i kopiach z console.log().

Blok kodu Markdown

Fragment kodu opakowany w trzy odwrócone apostrofy (```). LLM często automatycznie opakowują wynik JSON w ```json ... ```; bezpośrednie wklejenie do JSON.parse() spowoduje błąd.

Tolerant Parser / Parser tolerancyjny

Parser zdolny do próby odzyskania i kontynuowania analizy po napotkaniu błędów składniowych. Rdzeń narzędzia do naprawy JSON, w odróżnieniu od ścisłego JSON.parse.

SyntaxError

Wyjątek błędu składniowego zgłaszany przez JavaScript. Każdy ścisły parser JSON zgłasza go po otrzymaniu danych wejściowych niezgodnych z RFC 8259.

Canonical JSON / JSON kanoniczny

JSON ponownie wygenerowany przez parse + stringify, ze stabilną kolejnością kluczy, bez zbędnych białych znaków i 100% kompatybilnością ze standardowymi parserami. Ostateczny format wyjściowy narzędzia do naprawy JSON.

Typowe typy błędów naprawy JSON z przykładami

Naprawa JSON vs Formatowanie JSON vs Walidacja JSON Schema

Authoritative References

• IETFOficjalna specyfikacja JSON (RFC 8259)
• MDNJSON.parse - Dokumentacja MDN Web
• JSON5JSON5 - Nieoficjalna specyfikacja rozszerzonej składni
• GitHubjsonrepair (josdejong) - Implementacja referencyjna dla przeglądarki i Node