JSON Onarımı

İlgili Öneriler

JSON Onarımı (JSON Repair) Nedir?

Kullanım senaryoları

• AI/LLM çıktı temizliği: ChatGPT/Claude tarafından döndürülen Markdown sarmalayıcılı, açıklayıcı metinli ve sondaki virgüllü JSON'u tek tıklamayla standart JSON'a dönüştürün
• API hata ayıklama ve sorun giderme: API yanıtları ağ geçidi veya ağ sorunları nedeniyle kesildiğinde, orijinal veri yapısını bulmak için parantezleri ve dizeleri hızla tamamlayın
• Konsoldan kopyalanan JavaScript nesne literalleri: tek tırnaklar, sondaki virgüller ve tırnaksız anahtarlar için hepsi bir arada düzeltme
• Yapılandırma dosyası temizliği: JSON5/JSONC'deki yorumları kaldırarak standart JSON elde edin, alt akış hizmetlerine birleşik bağlantıya hazır hale getirin
• Günlük ve pano verisi onarımı: yorumlar, özel boşluklar veya kesilmeler içeren JSON parçalarını hızla standartlaştırın
• Veri taşıma ve betik ön işleme: birkaç geçersiz JSON'un tüm ETL yığınını engellemesini önlemek için veri taşıma hattına bir onarım adımı ekleyin

Nasıl Kullanılır

1. Hatalı, Markdown sarmalayıcılı veya kesik JSON içeriğini sol giriş kutusuna yapıştırın veya tipik bir bozuk JSON yüklemek için 'Örnek'e tıklayın veya bir .json/.txt dosyası yükleyin
2. Araç, yaygın sözdizimi sorunlarını otomatik olarak tespit edip düzeltir; sağ çıktı alanı, biçimlendirilmiş standart JSON'u ve her sorun türünün onarım sayısını gösterir
3. Kırmızı hata mesajları kalırsa, girişi manuel olarak düzenleyebilir ve onarımı yeniden tetikleyebilirsiniz (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Yapının doğru olduğunu onayladıktan sonra, onarım sonucunu panoya kopyalamak için 'Kopyala'ya tıklayın veya daha fazla biçimlendirme, doğrulama vb. için repaired.json olarak kaydetmek üzere 'İndir'e tıklayın

Özellikler

• 7 yaygın sözdizimi hatasını kapsar: sondaki virgüller, tek tırnaklar, tırnaksız anahtarlar, kapanmamış dizeler, yorumlar, eksik parantezler, Markdown kod bloğu sarmalayıcıları
• AI çıktı temizliği için optimize edilmiştir: ```json sarmalayıcılarını ve kod bloğu dışındaki açıklayıcı metni otomatik olarak kaldırır, ChatGPT, Claude, Gemini ve diğer LLM'lerin tipik çıktılarını tanır
• JSON5/JSONC uyumlu: yorumlar, gevşek tırnaklar ve özel boşluklar (görünmez Unicode karakterleri gibi) dahil genişletilmiş sözdizimini ayrıştırabilir
• Kesik JSON akıllı tamamlama: API yanıtlarının kesilmesi ve eksik kapanış parantezleri durumlarını, eksik parantezleri ve tırnakları otomatik tamamlayarak işler
• Onarım sorunu görselleştirme: Her sorun türünün kaç kez onarıldığını otomatik olarak sayar ve gösterir, denetim ve manuel incelemeyi kolaylaştırır
• Gizlilik için yerel işleme: ayrıştırma, onarım ve biçimlendirme tamamen tarayıcıda gerçekleşir, giriş içeriği hiçbir sunucuya gönderilmez
• Biçimlendirme ile sorunsuz geçiş: onarılan standart JSON, tek tıklamayla JSON Biçimlendirme, Şema Doğrulama ve kod üretimi gibi sonraki işlemlere aktarılabilir
• Dosya ve örnek yükleme: .json/.txt dosyası yüklemeyi veya örnek yüklemek için tıklamayı destekler, onarım etkisini hızlıca doğrulamayı sağlar

Kod Örnekleri

// 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']}

# Nesne/dizi sonundaki virgülleri kaldır (acil durum seçeneği; yorumları / tek tırnakları İŞLEMEZ)
# Karmaşık senaryolar için jsonrepair gibi özel bir kütüphane kullanın
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Onarılan çıktıyı doğrula
jq . clean.json >/dev/null && echo 'JSON is valid'

Sık Sorulan Sorular

Sorun Giderme

Sözlük

JSON

JavaScript Object Notation, RFC 8259'da tanımlanan anahtar-değer tabanlı hafif bir veri değişim formatı. REST API'ler, yapılandırma dosyaları ve günlükler için fiili standart.

RFC 8259

IETF tarafından yayınlanan resmi JSON belirtimi, geçerli JSON'un katı sözdizimini tanımlar — tüm anahtarlar çift tırnak içinde olmalıdır, dizelerde yalnızca sınırlı sayıda karakter kaçış gerektirir, yorumlara ve sondaki virgüllere izin verilmez.

JSON.parse

JavaScript ve modern tarayıcılara yerleşik katı JSON ayrıştırıcı, RFC 8259'u takip eder. Herhangi bir sözdizimi hatasında doğrudan SyntaxError fırlatır ve toleranslı onarım yapamaz.

JSON5

JSON için genişletilmiş sözdizimi (standart dışı), tırnaksız anahtarlara, tek tırnaklı dizelere, yorumlara (// ve /* */), sondaki virgüllere, onaltılık sayılara vb. izin verir. İnsanların yazması daha kolaydır ancak JSON.parse ile uyumsuzdur.

JSONC

JSON with Comments, VS Code gibi düzenleyicilerin yorumlu JSON yapılandırma dosyaları (tsconfig.json gibi) için kullandığı genel ad. Aslında JSON5'in yaygın bir takma adıdır.

Trailing Comma / Sondaki Virgül

Bir nesne veya dizinin son öğesinden sonraki fazladan virgül. JavaScript'te izin verilir ancak JSON standardı tarafından yasaklanmıştır — LLM çıktısı ve console.log() kopyalarında en yaygın sözdizimi hatasıdır.

Markdown Kod Bloğu

Üç ters tırnak (```) ile sarılmış bir kod parçacığı. LLM'ler JSON çıktısını verirken genellikle otomatik olarak ```json ... ``` ile sarar; doğrudan JSON.parse() işlevine yapıştırmak başarısız olur.

Tolerant Parser / Toleranslı Ayrıştırıcı

Sözdizimi hatalarıyla karşılaştığında kurtarmayı deneyen ve ayrıştırmaya devam edebilen bir ayrıştırıcı. JSON Onarım aracının çekirdek motoru, katı JSON.parse'ten farklıdır.

SyntaxError

JavaScript tarafından fırlatılan sözdizimi hatası istisnası. Herhangi bir katı JSON ayrıştırıcı, RFC 8259'a uymayan giriş aldığında bu hatayı fırlatır.

Canonical JSON / Kanonik JSON

Parse + stringify ile yeniden oluşturulmuş JSON, kararlı anahtar sırası, fazladan boşluk olmadan ve standart ayrıştırıcılarla %100 uyumlu. JSON Onarım aracının nihai çıktı formatı.

Yaygın JSON Onarım Hata Türleri ve Örnekleri

JSON Onarımı vs JSON Biçimlendirme vs JSON Şema Doğrulaması

Authoritative References

• IETFJSON Resmi Belirtimi (RFC 8259)
• MDNJSON.parse - MDN Web Belgeleri
• JSON5JSON5 - Resmi olmayan genişletilmiş sözdizimi belirtimi
• GitHubjsonrepair (josdejong) - Tarayıcı ve Node için referans uygulama