JSON Biçimlendirici

Bu basit araçla JSON'unuzu biçimlendirin ve güzelleştirin

Ham JSON Girişi*

Biçimlendirilmiş JSON Çıkışı

Biçimlendirilmiş JSON burada görünecek...

JSON Formatlayıcı

Giriş

JSON (JavaScript Nesne Notasyonu), web uygulamalarında veri alışverişi için standart haline gelmiş hafif bir veri değişim formatıdır. Basitliğine rağmen, JSON verileri sıkıştırıldığında veya uygun biçimlendirme eksik olduğunda okunması zor hale gelebilir. Bu araç, ham, biçimlendirilmemiş JSON dizelerini daha yapılandırılmış, girintili bir formata dönüştürmenize yardımcı olur; bu da okunmasını ve analiz edilmesini çok daha kolay hale getirir.

JSON biçimlendirme (aynı zamanda "güzel yazım" olarak da bilinir), JSON verilerinin hiyerarşik yapısını görsel olarak belirgin hale getirmek için tutarlı girintileme, satır sonları ve boşluklar ekler. Bu, karmaşık iç içe geçmiş nesneler veya büyük veri setleri ile çalışırken, öğeler arasındaki ilişkilerin aksi takdirde anlaşılması zor olabileceği durumlarda özellikle değerlidir.

JSON biçimlendirici aracımız, JSON verilerinizi uygun girintileme ve yapı ile güzelleştirmek için basit bir arayüz sunar; bu, insanlara daha okunabilir hale gelirken makineler için geçerliliğini korur.

JSON Söz Dizimi ve Yapısı

JSON, iki temel yapı üzerine kuruludur:

Nesneler: Süslü parantezler {} içinde yer alan ad/değer çiftlerinin koleksiyonları. Her ad, bir iki nokta üst üste : ile takip edilir ve çiftler virgül , ile ayrılır.

   {"name": "John", "age": 30, "city": "New York"}

Diziler: Köşeli parantezler [] içinde yer alan değerlerin sıralı listeleri. Değerler virgül , ile ayrılır.

   ["apple", "banana", "cherry"]

JSON değerleri şunlar olabilir:

Dize (çift tırnak içinde): "Merhaba Dünya"
Sayılar: 42 veya 3.14159
Boolean: true veya false
Null: null
Nesneler: {"anahtar": "değer"}
Diziler: [1, 2, 3]

Geçerli JSON, bu söz dizimi kurallarına uymalıdır:

İsimler çift tırnak içinde olmalıdır
Değerler geçerli JSON veri türlerinden biri olmalıdır
Sonlandırıcı virgüller olmamalıdır
Yorumlar yasaktır
Fonksiyonlar veya yöntemler yasaktır

Yaygın söz dizimi hataları şunlardır:

Eksik veya eşleşmeyen parantezler/küme parantezleri
Özellik adlarının etrafında eksik tırnaklar
Tek tırnak yerine çift tırnak kullanma
Sonlandırıcı virgüller ekleme
Değer olarak tanımsız kullanma

JSON Biçimlendirme Nasıl Çalışır

JSON biçimlendirme, sıkıştırılmış, minify edilmiş JSON'u daha okunabilir bir forma dönüştürerek:

Ayrıştırma: JSON dizesi önce geçerli olduğundan emin olmak için ayrıştırılır ve veri yapısının bellekteki temsili oluşturulur.
Girintileme: Her iç içe nesne ve dizi seviyesi, hiyerarşiyi görsel olarak temsil etmek için (genellikle 2 veya 4 boşluk) girintilenir.
Satır Sonları: Her özellik veya dizi öğesinden sonra yeni satırlar eklenir.
Boşluklar: İki nokta üst üste ve virgüller etrafında tutarlı boşluklar eklenir.

Örneğin, bu minify edilmiş JSON:

{"name":"John Doe","age":30,"address":{"street":"123 Main St","city":"Anytown","state":"CA"},"hobbies":["reading","hiking","photography"]}

Bu biçimlendirilmiş JSON'a dönüşür:

{
  "name": "John Doe",
  "age": 30,
  "address": {
    "street": "123 Main St",
    "city": "Anytown",
    "state": "CA"
  },
  "hobbies": [
    "reading",
    "hiking",
    "photography"
  ]
}

Biçimlendiricimiz, her seviye için 2 boşlukluk standart bir girintileme kullanır; bu, geliştirme topluluğunda yaygın bir gelenektir ve sıkışıklık ile okunabilirlik arasında iyi bir denge sağlar.

JSON Doğrulama

JSON biçimlendirme işleminin kritik bir yönü doğrulamadır. JSON biçimlendirilmeden önce, JSON spesifikasyonuna göre söz dizimsel olarak geçerli olmalıdır. Yaygın doğrulama hataları şunlardır:

Söz Dizimi Hataları:
- Alıntılanmamış özellik adları
- Eksik veya fazla virgüller
- Yanlış iç içe yapılar
- Kapalı olmayan dizeler, nesneler veya diziler
Veri Türü Hataları:
- JavaScript'e özgü değerler (tanımsız veya NaN gibi) kullanma
- Fonksiyonlar veya yöntemler ekleme
- Dize için tek tırnak kullanma

Geçersiz JSON ile karşılaştığınızda, hata mesajı sorunu tanımlamaya yardımcı olabilir. Çoğu JSON ayrıştırıcısı, ayrıştırmanın başarısız olduğu yeri belirten bir konum gösterecektir; bu, sorunu bulmanıza yardımcı olabilir. Araçlarımız, JSON verilerinizdeki sorunları tanımlamanıza ve düzeltmenize yardımcı olmak için net hata mesajları sağlar.

Kullanım Durumları

JSON biçimlendirme, birçok senaryoda değerlidir:

API Geliştirme ve Testi

RESTful API'lerle çalışırken, biçimlendirilmiş JSON, daha kolay hale getirir:

Yanıt yüklerini incelemek
İstek gövdelerini hata ayıklamak
API örneklerini belgelemek
Veri yapılarını beklentilerle karşılaştırmak

Yapılandırma Yönetimi

Birçok modern uygulama JSON'u yapılandırma için kullanır:

Uygulama ayar dosyaları
Ortam yapılandırmaları
Derleme ve dağıtım spesifikasyonları
Kod olarak Altyapı şablonları (ör. AWS CloudFormation, Terraform)

Veri Analizi ve Görselleştirme

Biçimlendirilmiş JSON, aşağıdaki durumlarda yardımcı olur:

Veri setlerini keşfetmek
Görselleştirme için veri hazırlamak
Veri şemalarını anlamak
Yapılandırılmış verilerdeki kalıpları tanımlamak

Hata Ayıklama ve Sorun Giderme

Uygun biçimlendirilmiş JSON, aşağıdaki durumlarda gereklidir:

Web uygulamalarını hata ayıklamak
localStorage veya sessionStorage'ı incelemek
Ağ yanıtlarını analiz etmek
Veri entegrasyon sorunlarını çözmek

Eğitim Amaçları

Açık JSON biçimlendirme, aşağıdaki durumlar için değerlidir:

Veri yapılarını öğretmek
İç içe geçmiş ilişkileri göstermek
API kavramlarını açıklamak
Veri modelleme ilkelerini anlatmak

Alternatifler

Web tabanlı JSON biçimlendiricimiz, hızlı biçimlendirme görevleri için kullanışlı olsa da, farklı senaryolar için birkaç alternatif vardır:

Tarayıcı Geliştirici Araçları

Modern tarayıcılar, JSON biçimlendirme yetenekleri içerir:

Chrome ve Edge Geliştirici Araçları, Ağ sekmesinde JSON yanıtlarını otomatik olarak biçimlendirir
Firefox'un JSON görüntüleyicisi, etkileşimli bir ağaç görünümü sağlar
JSONView gibi tarayıcı uzantıları, JSON'u doğrudan tarayıcıda biçimlendirebilir

Kod Editörleri ve IDE'ler

Çoğu geliştirme ortamı, JSON biçimlendirme sunar:

Visual Studio Code, yerleşik JSON biçimlendirmeye sahiptir (Alt+Shift+F)
JetBrains IDE'leri (WebStorm, IntelliJ) güçlü JSON araçları içerir
Sublime Text ve Atom, eklentiler aracılığıyla JSON biçimlendirme destekler

Komut Satırı Araçları

Terminal kullanıcıları veya otomasyon için:

jq, hafif ve esnek bir komut satırı JSON işlemcisidir
json_pp, birçok Unix sisteminde önceden yüklenmiştir
python -m json.tool, Python kullanarak hızlı biçimlendirme sağlar

Programatik Yaklaşımlar

Uygulamalar içinde JSON biçimlendirme yaparken:

// JavaScript
const formatted = JSON.stringify(jsonObject, null, 2);

# Python
import json
formatted = json.dumps(json_object, indent=2)

// Java ile Gson
Gson gson = new GsonBuilder().setPrettyPrinting().create();
String formatted = gson.toJson(jsonObject);

# Ruby
require 'json'
formatted = JSON.pretty_generate(json_object)

// PHP
$formatted = json_encode($jsonObject, JSON_PRETTY_PRINT);

Tarihçe

JSON, Douglas Crockford tarafından 2000'lerin başında XML'e hafif bir alternatif olarak oluşturulmuştur. Format, JavaScript nesne literal söz diziminden türetilmiştir ancak dil bağımsız olacak şekilde tasarlanmıştır. 2006 yılında, JSON RFC 4627'de resmi olarak belirtilmiştir ve basitliği ve JavaScript ile uyumu sayesinde hızla popülerlik kazanmıştır.

JSON'dan önce, XML veri alışverişi için baskın formattı, ancak hacminin fazla olması ve karmaşıklığı birçok uygulama için zahmetli hale getirmiştir. JSON, daha okunabilir ve yazılabilir bir söz dizimi sunarak, hem insanlar hem de makineler için daha kolay hale gelmiştir. Ayrıca, JavaScript'in nesne modeline mükemmel bir şekilde uyum sağlamış ve web uygulamaları için doğal bir seçim olmuştur.

JSON'un benimsenmesi, 2000'lerin ortalarında AJAX ve RESTful API'lerin yükselişi ile hızlanmıştır. 2010'larda, web API'leri, yapılandırma dosyaları ve MongoDB ve CouchDB gibi NoSQL veritabanlarında veri depolamak için geçerli standart haline gelmiştir.

Bugün, JSON hemen hemen her programlama dili tarafından desteklenmektedir ve web üzerindeki sayısız uygulamada kullanılmaktadır. Basitliği, esnekliği ve evrensel desteği, onu modern bilgisayarlarda en önemli veri formatlarından biri haline getirmiştir.

Kod Örnekleri

İşte çeşitli programlama dillerinde JSON biçimlendirme ile ilgili örnekler:

// JavaScript JSON biçimlendirme
function formatJSON(jsonString) {
  try {
    const parsedData = JSON.parse(jsonString);
    return JSON.stringify(parsedData, null, 2);
  } catch (error) {
    return `Hata: ${error.message}`;
  }
}

// Örnek kullanım
const rawJSON = '{"name":"John","age":30,"city":"New York"}';
console.log(formatJSON(rawJSON));

# Python JSON biçimlendirme
import json

def format_json(json_string):
    try:
        parsed_data = json.loads(json_string)
        return json.dumps(parsed_data, indent=2)
    except json.JSONDecodeError as e:
        return f"Hata: {str(e)}"

# Örnek kullanım
raw_json = '{"name":"John","age":30,"city":"New York"}'
print(format_json(raw_json))

// Java JSON biçimlendirme ile Gson
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonSyntaxException;

public class JSONFormatter {
    public static String formatJSON(String jsonString) {
        try {
            Gson gson = new GsonBuilder().setPrettyPrinting().create();
            Object parsedJson = gson.fromJson(jsonString, Object.class);
            return gson.toJson(parsedJson);
        } catch (JsonSyntaxException e) {
            return "Hata: " + e.getMessage();
        }
    }
    
    public static void main(String[] args) {
        String rawJSON = "{\"name\":\"John\",\"age\":30,\"city\":\"New York\"}";
        System.out.println(formatJSON(rawJSON));
    }
}

// PHP JSON biçimlendirme
function formatJSON($jsonString) {
    $result = json_decode($jsonString);
    if (json_last_error() !== JSON_ERROR_NONE) {
        return "Hata: " . json_last_error_msg();
    }
    return json_encode($result, JSON_PRETTY_PRINT);
}

// Örnek kullanım
$rawJSON = '{"name":"John","age":30,"city":"New York"}';
echo formatJSON($rawJSON);

# Ruby JSON biçimlendirme
require 'json'

def format_json(json_string)
  begin
    parsed_data = JSON.parse(json_string)
    return JSON.pretty_generate(parsed_data)
  rescue JSON::ParserError => e
    return "Hata: #{e.message}"
  end
end

# Örnek kullanım
raw_json = '{"name":"John","age":30,"city":"New York"}'
puts format_json(raw_json)

// C# JSON biçimlendirme ile Newtonsoft.Json
using Newtonsoft.Json;
using System;

class JSONFormatter
{
    public static string FormatJSON(string jsonString)
    {
        try
        {
            object parsedJson = JsonConvert.DeserializeObject(jsonString);
            return JsonConvert.SerializeObject(parsedJson, Formatting.Indented);
        }
        catch (JsonException e)
        {
            return $"Hata: {e.Message}";
        }
    }
    
    static void Main()
    {
        string rawJSON = "{\"name\":\"John\",\"age\":30,\"city\":\"New York\"}";
        Console.WriteLine(FormatJSON(rawJSON));
    }
}

// Go JSON biçimlendirme
package main

import (
    "encoding/json"
    "fmt"
)

func formatJSON(jsonString string) string {
    var parsedData interface{}
    err := json.Unmarshal([]byte(jsonString), &parsedData)
    if err != nil {
        return fmt.Sprintf("Hata: %s", err.Error())
    }
    
    formattedBytes, err := json.MarshalIndent(parsedData, "", "  ")
    if err != nil {
        return fmt.Sprintf("Hata: %s", err.Error())
    }
    
    return string(formattedBytes)
}

func main() {
    rawJSON := `{"name":"John","age":30,"city":"New York"}`
    fmt.Println(formatJSON(rawJSON))
}

Kenar Durumları ve Dikkate Alınacaklar

JSON biçimlendirme ile çalışırken, bu potansiyel zorlukların farkında olun:

Büyük JSON Dosyaları

Çok büyük JSON dosyaları (birkaç megabayt veya daha fazla) web tabanlı biçimlendiricilerde performans sorunlarına neden olabilir. Bu tür durumlar için:

Komut satırı araçları kullanmayı düşünün, örneğin jq
JSON'u daha küçük parçalara ayırın
Belleğe tüm dosyayı yüklemeden işlemek için akış ayrıştırıcıları kullanın

Derin İç İçe Yapılar

Son derece iç içe geçmiş JSON (10-20 seviyeden daha fazla) biçimlendirilse bile gezinmesi zor hale gelebilir. Bu durumlarda:

Mümkünse yapıyı düzleştirmeyi düşünün
Katlanabilir JSON görüntüleyicileri kullanın
JSON'un belirli bölümleriyle çalışın

Özel Karakterler ve Unicode

JSON, Unicode'u destekler, ancak bazı biçimlendiriciler belirli karakterlerle sorun yaşayabilir:

Araçlarınızın emoji ve diğer Unicode karakterlerini doğru bir şekilde işlediğinden emin olun
Kontrol karakterleri ve kaçış dizileri ile dikkatli olun
Biçimlendirilmiş çıktının tüm orijinal karakterleri koruduğunu doğrulayın

Sayısal Hassasiyet

JSON, sayılar için hassasiyet belirtmez; bu da çok büyük tam sayılar veya kayan nokta değerleri ile sorunlara yol açabilir:

JavaScript uygulamalarının 53 bitten daha büyük tam sayılar için hassasiyet kaybı yaşayabileceğini unutmayın
Hassas sayısal değerler için dize temsilleri kullanmayı düşünün
Uygulamanız yüksek hassasiyet gerektiriyorsa aşırı değerlerle test yapın

Boş Nesneler ve Diziler

Geçerli JSON, boş nesneleri {} ve dizileri [] içerir; bunlar düzgün bir şekilde biçimlendirilmelidir:

Boş nesneler {} olarak görünmelidir
Boş diziler [] olarak görünmelidir
İç içe geçmiş boş yapılar, uygun girintilemeyi korumalıdır

Referanslar

JSON.org - Resmi JSON spesifikasyon web sitesi
RFC 8259 - JSON Veri Değişim Formatı
MDN Web Docs: JSON - JavaScript'te JSON hakkında kapsamlı belgeler
JSON Lint - Popüler bir çevrimiçi JSON doğrulayıcı
jq - Hafif ve esnek bir komut satırı JSON işlemcisi

İlgili Araçlar

Zaman Birimi Dönüştürücü: Yıllar, Günler, Saatler, Dakikalar, Saniyeler

Base64 Kodlayıcı ve Çözümleyici: Metni Base64'e Dönüştür

Metin Ters Çevirici Aracı: Herhangi Bir Dizedeki Karakter Sırasını Tersine Çevir

Unix Zaman Damgası Tarih Dönüştürücü: 12/24 Saat Formatı Desteği

İkinci Dereceden Denklem Çözücü: ax² + bx + c = 0 Köklerini Bul

Rastgele API Anahtar Üretici: Güvenli 32 Karakterli Dize Oluşturun