Tarayıcınızı çökertmeden devasa bir JSON dosyasını nasıl görüntüleyebilirsiniz?

50 MB’lık bir API dökümü veya tam bir veritabanı dışa aktarımını herhangi bir tarayıcı tabanlı JSON aracına — bu araç da dahil — yapıştırmak, sekmenin yavaşlamasına veya tamamen donmasına neden olur. Bu, belirli bir araçtaki bir hata değil; tarayıcıların metni ve DOM’u işleme biçiminin bir özelliğidir. İşte gerçekte neler olduğu ve bu sorunu nasıl aşabileceğiniz.

Neden büyük JSON dosyaları tarayıcıyı sadece “yavaş yüklemekle” kalmayıp donduruyor?

İki ayrı maliyet birikiyor:

Ayrıştırma maliyeti. Normal bir dizüstü bilgisayarda, iyi biçimlendirilmiş 50 MB’lık bir dizeyi JSON.parse ile ayrıştırmak yaklaşık yarım saniyeden birkaç saniyeye kadar sürer — bu fark edilebilir bir durumdur, ancak asıl sorun bu değildir.
Görüntüleme maliyeti. Aslında sekmeyi donduran budur. Bir araç, biçimlendirilmiş sonucu devasa bir metin bloğu olarak (ya da daha kötüsü, her anahtar için bir DOM düğümü içeren daraltılabilir bir ağaç olarak) görüntülerse, tarayıcı potansiyel olarak milyonlarca DOM düğümünü düzenlemek ve çizmek zorunda kalır. Sekmeyi yanıt vermez hale getiren işte budur, ayrıştırma değil.

Dolayısıyla, karşılaştığınız boyut sınırı neredeyse hiçbir zaman JSON spesifikasyonundan veya ayrıştırıcıdan kaynaklanmaz — tarayıcıdan bir anda muazzam miktarda metin veya iç içe geçmiş kullanıcı arayüzü çizmesini istemenizden kaynaklanır.

Gerçekten büyük dosyalar için asıl iş akışı

Dosyanın tamamını tarayıcıda hiçbir yerde açmayın. Bunun yerine:

Önce sadece ihtiyacınız olan kısmı ayıklayın. 200 MB’lık bir döküm içindeki tek bir bozuk kaydı hata ayıklıyorsanız, önünüzde kalan diğer 199 MB’a ihtiyacınız yoktur. Komut satırı araçları, tarayıcı sekmesinin yaptığı gibi dosyayı belleğe tamamen yüklemeden bu işlemi halleder:

# pull out one top-level key from a huge file, streaming
jq '.results[42]' huge-file.json > fragment.json

# or just grep for context around a known string first
grep -n '"user_id": 88214' huge-file.json

Tarayıcıda yalnızca o parçayı biçimlendirin. Çıkarılan birkaç KB’lık JSON anında biçimlenir ve gerçekten okunabilir hale gelir — bu, sadece bu belirli hata için değil, herhangi bir büyük günlük veya döküm dosyası için de geliştirmeye değer olan “yalnızca ilgilendiğiniz parçayı biçimlendirin” alışkanlığıdır.
Değerleri değil, yapıyı incelemek zorundaysanız, neyi ayıklayacağınıza karar vermeden önce yapıyı anlamak için önce yerel olarak jq 'keys' veya jq '. | length' komutlarını çalıştırın. Dizinin 50.000 girdisi olduğunu bilmek için 50.000 dizi girdisini görmenize gerek yoktur.

Bir tarayıcı aracının gerçekten yeterli olduğu durumlar

Gerçek hata ayıklamanın büyük çoğunluğunda — bir API yanıtı, bir yapılandırma dosyası, bir webhook yükü — yüzlerce değil, kilobayt ile birkaç megabayt arasında bir boyutla uğraşırsınız. Bu aralıkta, verileri doğrudan bir biçimlendiriciye yapıştırıp, hataların tam konumlarını içeren anında ve okunabilir bir çıktı elde etmek, komut satırına başvurmaktan çok daha hızlıdır. Bu yöntemin işe yaramadığı boyut, çoğu kişinin sandığından çok daha yüksektir; asıl sorunu yaratan, “bir sayfadan fazla” değil, özellikle “onlarca megabayt ve üzeri” boyutlardaki verileridir.

Hızlı başvuru

Dosya boyutu	Ne yapmalı
~5 MB’nin altında	Doğrudan tarayıcı biçimlendiricisine yapıştırın — anında ve sorunsuz
~5–30 MB	Hâlâ kullanılabilir, ancak kısa bir duraklama bekleyin; yalnızca okumanız gereken kısmı biçimlendirin
30 MB ve üzeri	Önce `jq` / `grep` ile ilgili bölümü ayıklayın, sadece onu biçimlendirin

Bu sorunu çözmek için aracın bir “büyük dosya moduna” ihtiyacı yoktur — çözüm, görüntülemeden önce ayıklamaktır; bu bir iş akışı değişikliğidir, araç sınırlaması değildir.