SSE'den JSON'a

SSE Stream
Blank line separates events0 lines0 chars
JSON Array0

Formatted JSON shows up here

Paste id/event/data blocks separated by blank lines on the left, and each event becomes one item of the JSON array.

0 eventsWaiting for input

Server-Sent Events (SSE) push verisi için odaklı bir dönüştürücü. Solda ham id/event/data bloklarını yapıştırın, sağda hemen her push olayının kendi id'si, olay adı ve ayrıştırılmış veri yüküyle tek bir nesneye dönüştüğü standart bir JSON dizisi görünür.

İlgili Öneriler

SSE'den JSON'a dönüştürme nedir?

Server-Sent Events (SSE), sunucunun `text/event-stream` tipindeki bir HTTP yanıtı üzerine UTF-8 metin olayları yazdığı tek yönlü bir akış protokolüdür. Tel üzerinde her olay `id: 1`, `event: MESSAGE` ve `data: {...}` gibi alan satırlarından oluşan bir dizidir ve boş bir satır o olayın bittiğini işaret eder.

Ham SSE taşıma için kullanışlıdır ama okuması ve hata ayıklaması zordur. Alan adları her olayda tekrarlanır, JSON yükü bir `data:` önekinin arkasında durur ve uzun akışlar bir metin duvarına dönüşür. SSE'yi JSON'a çevirmek, her olayı düz bir nesneye normalleştirmek ve tüm olayları tek bir JSON dizisinde toplamak demektir.

Bu dönüştürücü event-stream yorumlama kurallarını izler: satır sonlarına göre böler, boş satırı dağıtım sınırı sayar, alan iki noktasından sonraki tek opsiyonel boşluğu kaldırır, tekrarlanan data satırlarını satır sonlarıyla birleştirir ve iki noktayla başlayan yorumları yok sayar. Ardından her veri yükünü JSON olarak ayrıştırır ki iç içe yapılar korunsun.

Sonuç standart, girintili bir JSON dizisidir; okuması, koda kopyalaması, başka bir yakalamayla karşılaştırması ya da sonraki araçlara beslemesi kolaydır; ayrıştırılamayan her yük ise düşürülmek üzere işaretlenir.

Kullanım senaryoları

  • STREAM_CHUNK veya CHUNK_DELTA gibi SSE olay parçaları halinde gelen LLM ya da AI aracı akış yanıtlarında hata ayıklayın
  • Tarayıcı DevTools Network sekmesinden kopyalanan bir text/event-stream yanıtını okunabilir JSON'a çevirin
  • Gerçek zamanlı bir push ya da sohbet arka ucundan gelen heartbeat, ack ve tam mesaj olaylarını inceleyin
  • Yakalanan SSE push verisini, hata ayıklamak üzere bir iş arkadaşınızla paylaşmadan önce JSON dizisine çevirin
  • Her olayın iç içe veri yükünü elle data: öneklerini kaldırmadan çıkarın ve genişletin
  • Kaydedilmiş bir push akışını çevrimdışı yeniden oynatın ve olay sıralamasını id'ye göre karşılaştırın
  • JSON dizisi bekleyen analiz, log ya da elektron tabloları için SSE olay verisini hazırlayın
  • Ön uç-arka uç entegrasyonu sırasında sunucunun beklenen olay adlarını ve yük biçimini yaydığını doğrulayın
  • Çok satırlı data alanlarını her olay nesnesi için tek bir ayrıştırılmış değere indirin
  • Proxy'lerden, ağ geçitlerinden ya da curl çıktısından gelen SSE izlerini yapılandırılmış, katlanabilir bir biçimde inceleyin
  • SSE tel biçimini yeniden kullanan Webhook tarzı ya da mesaj kuyruğu olay akışlarını JSON'a çevirin
  • id, event ve data'nın JSON nesnelerine nasıl eşlendiğini görerek Server-Sent Events tel biçimini öğrenin

Nasıl Kullanılır

  1. Ham SSE akışını soldaki textarea'ya yapıştırın; id/event/data satırları olsun ve olayların arasında boş satır bulunsun
  2. Sağ taraf otomatik güncellenir ve her olay için bir nesne olan bir JSON dizisi gösterir
  3. Bir veri yükü geçerli JSON değilse ya da bir alan bozuk görünüyorsa uyarı panelini kontrol edin
  4. Tüm JSON dizisini kopyalamak için Kopyala'yı kullanın ya da önce yerleşik bir örneği yüklemek için Örnek'e basın

Özellikler

  • Ham bir SSE olay akışını, her push olayı için bir nesne olacak şekilde standart bir JSON dizisine dönüştürür
  • Satırları boş satıra göre olaylara göre gruplandırır; Server-Sent Events dağıtım modelini takip eder
  • Her alanı alan: değer olarak ayrıştırır ve iki noktadan sonraki tek boşluğu kaldırır
  • Her veri yükünü JSON.parse ile ayrıştırır; böylece iç içe yükler kaçışlı dizeler değil gerçek nesneler olur
  • id, event, data anahtar sırasını sabit tutar ve sayısal id'leri JSON sayısına çevirir
  • Çok satırlı data alanlarını, iki noktayla başlayan yorum satırlarını ve sondaki boş satırı olmayan akışları destekler
  • Geçersiz veri yüklerini ve bilinmeyen ya da bozuk alanları blok ve satır numaralarıyla raporlar
  • Bölünmüş textarea girişi ve JSON önizleme düzeni; örnek, temizle, kopyala ve olay istatistikleri içerir; tamamen tarayıcıda çalışır

SSE'den JSON vs JSONL biçimlendirici vs JSON biçimlendirici

Bu araçlar farklı girdi biçimlerini ele alır. Doğru olanı seçmek, önekleri elle kaldırma ve dizileri sarma zahmetini ortadan kaldırır.

AraçEn uygun girdiTemel yetenekKullanım senaryosu
SSE'den JSON'aBoş satırlarla bölünmüş id/event/data bloklarıSSE alanlarını anlar ve her veri yükünü ayrıştırırSunucu push akışları, text/event-stream, AI akış parçaları
JSONL BiçimlendiriciSatır başına eksiksiz bir JSON nesnesiHer satırı bağımsız olarak doğrular ve biçimlendirirNDJSON logları, arşivlenmiş olaylar, satırla ayrılmış dışa aktarımlar
JSON BiçimlendiriciEksiksiz bir JSON nesnesi ya da dizisiTek bir bütün JSON belgesini düzenlerAPI yanıtları, yapılandırma dosyaları, tek seferlik yükler

Best Practices

Bir akışı kopyalarken olaylar arasındaki boş satırı koruyun

Bir SSE olayını bir sonrakinden ayıran şey boş satırdır. Kopyalarken boş satırları çıkarırsanız ayrı olaylar tek bir blokta birleşebilir ve dönüşüm artık orijinal dağıtım sırasıyla eşleşmez.

Soruna atlamak için uyarılardaki blok ve satır numaralarını kullanın

Bir veri yükü ayrıştırılamadığında uyarı, olay bloğunu ve suçlu satırı adlandırır. Bu bloğu yakındaki geçerli bir olayla karşılaştırarak kısaltılmış bir süslü parantezi, eksik tırnağı ya da birbirine yapışmış parçaları fark edin.

Unutmayın: yalnızca data alanı JSON olarak ayrıştırılır

id, event ve retry alanları SSE taşıma meta verisidir ve skaler değerler olarak kalır. Dönüştürücüden olay adı ya da id içinde görünen JSON'u ayrıştırmasını beklemeyin; yapısal içerik data'ya aittir.

Tam bir mesajı dönüştürmeden önce kısmi akış parçalarını bir araya getirin

Birçok AI akışı tek bir mesajı oluşturan çok sayıda küçük STREAM_CHUNK olayı gönderir. Önce tüm yakalamayı dönüştürerek her parçayı bir dizi öğesi olarak görün; nihai mesaja ihtiyacınız varsa parça yüklerini uygulama kodunuzda birleştirin.

Dönüştürülen JSON'u paylaşmadan önce hassas yükleri temizleyin

Dönüşüm yereldir ama JSON dizisini bir talebe ya da sohbete kopyaladığınız anda makinenizden çıkar. Paylaşmadan önce çıktıdaki token'ları, kullanıcı id'lerini ve özel sohbet metinlerini kaldırın.

Sık Sorulan Sorular

SSE (Server-Sent Events) nedir?

SSE, sunucunun `text/event-stream` içerik tipini kullanarak HTTP üzerinden tarayıcıya metin olayları göndermesinin standart bir yoludur. Her olay `id`, `event` ve `data` gibi metin satırlarından oluşur ve olaylar birbirinden boş bir satırla ayrılır.

Bu araç akışı olaylara nasıl böler?

SSE dağıtım modelini izler: girdi satırlara bölünür, ardışık boş olmayan satırlar tek bir olay bloğu oluşturur ve boş bir satır o bloğu yeni bir olay olarak dağıtır. Sonda boş satırı olmayan son blok da yine yayımlanır ve iki noktayla başlayan yorum satırları yok sayılır.

Çıktı JSON'u nasıl görünür?

Sonuç tek bir JSON dizisidir. Her girdi olayı, mevcut olan alanlarla id, event, data sabit sırada tek bir nesne olur. `data` metni JSON.parse ile ayrıştırılır; böylece `data: {"a":1}` gibi bir yük, kaçışlı bir dize yerine iç içe bir `"data": {"a":1}` nesnesine dönüşür.

Çıktıda id neden sayı olarak görünüyor?

SSE id'leri teknik olarak dizelerdir, ancak gerçek push akışları neredeyse her zaman `id: 0` gibi sayısal id'ler kullanır. Bir id yalnızca rakamlardan oluşuyorsa dönüştürücü onu JSON sayısı olarak yayar; başka türlü her id dize olarak korunur.

data birden fazla satıra yayılırsa ne olur?

SSE belirtimine göre tek bir olay içindeki birden çok `data:` satırı, tek bir değer olarak ayrıştırılmadan önce bir satır sonu karakteriyle birleştirilir. Birleştirilmiş metin geçerli JSON değilse dönüştürücü ham metni korur ve hiçbir şeyin sessizce kaybolmaması için bir uyarı ekler.

Bir veri yükü geçerli JSON değilse ne olur?

Tüm dönüşüm başarısız olmak yerine, o olay ham veriyi JSON dizesi olarak korur ve sayfa blok numarası ile ayrıştırıcı hata mesajını içeren bir uyarı gösterir. Etrafındaki geçerli olaylar normal biçimde dönüştürülmeye devam eder.

SSE'den JSON ile JSONL biçimlendirici arasındaki fark nedir?

JSONL her satırda eksiksiz bir JSON nesnesi tutar. SSE ise boş satırlarla olaylara gruplanmış etiketli `id/event/data` satırları tutar ve yalnızca data bölümü JSON'dur. SSE'den JSON bu alan etiketlerini ve boş satır olay sınırlarını anlar; bir JSONL biçimlendirici ise her satırı bağımsız ele alır.

Bu dönüştürücü akış verilerimi yükler mi?

Hayır. Ayrıştırma ve biçimlendirme tamamen tarayıcınızda çalışır; dolayısıyla push verileri, token'lar ve sohbet içerikleri makinenizden asla çıkmaz.

Sözlük

SSE
Server-Sent Events; HTTP üzerinden sunucudan istemciye tek yönlü push akışı için bir standart.
text/event-stream
Boş satırlarla ayrılmış alan satırları içeren bir SSE yanıt gövdesinin MIME ortam tipi.
Olay bloğu
Birlikte bir push olayını betimleyen ve boş bir satırla sonlanan ardışık boş olmayan alan satırları grubu.
data alanı
Olay yükünü taşıyan SSE alanı; tek bir olaydaki birden çok data satırı bir satır sonuyla birleştirilir ve genellikle JSON'dur.
event alanı
Olay tipini adlandıran opsiyonel alan; yoksa tarayıcı onu genel 'message' olayı olarak dağıtır.
id alanı
Akışı sürdürmek için kullanılan opsiyonel last-event-id değeri; bu dönüştürücü sayısal id'leri JSON sayısı olarak yayar.
retry alanı
İstemciye yeniden bağlanma bekleme süresini milisaniye cinsinden bildiren opsiyonel alan; yalnızca ASCII rakamları içermelidir.
Yorum satırı
İki noktayla başlayan, genellikle heartbeat ya da keep-alive olarak kullanılan ve olaylar oluşturulurken yok sayılan satır.

Authoritative References