SSE vers JSON

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

Un convertisseur dédié aux données en push Server-Sent Events (SSE). Collez à gauche les blocs bruts id/event/data, et la droite affiche instantanément un tableau JSON standard où chaque événement diffusé devient un objet unique avec son id, son nom d'événement et sa charge de données analysée.

Recommandations connexes

Que signifie la conversion SSE vers JSON ?

Les Server-Sent Events (SSE) sont un protocole de streaming unidirectionnel dans lequel un serveur écrit des événements texte UTF-8 sur une réponse HTTP de type `text/event-stream`. Sur le câble, chaque événement est une séquence de lignes de champ telles que `id: 1`, `event: MESSAGE` et `data: {...}`, et une ligne vide marque la fin de cet événement.

Le SSE brut est pratique pour le transport mais malcommode à lire et à déboguer. Les noms de champ se répètent sur chaque événement, la charge JSON se trouve derrière un préfixe `data:`, et les longs flux se résorbent en un mur de texte. Convertir SSE vers JSON consiste à normaliser chaque événement en un objet simple et à rassembler tous les événements dans un seul tableau JSON.

Ce convertisseur suit les règles d'interprétation de l'event-stream : il découpe sur les fins de ligne, traite la ligne vide comme la frontière de distribution, retire exactement un espace facultatif après le deux-points du champ, joint les lignes data répétées par des sauts de ligne et ignore les commentaires préfixés d'un deux-points. Il analyse ensuite chaque charge de données en JSON afin de préserver les structures imbriquées.

Le résultat est un tableau JSON standard et indenté, facile à lire, à copier dans du code, à comparer par diff avec une autre capture ou à transmettre à des outils en aval, tandis que toute charge non analysable est signalée plutôt que supprimée.

Cas d'utilisation

  • Déboguer les réponses en streaming de modèles de langage ou d'agents IA qui arrivent sous forme de blocs d'événements SSE tels que STREAM_CHUNK ou CHUNK_DELTA
  • Transformer une réponse text/event-stream copiée depuis l'onglet Réseau des outils de développement du navigateur en JSON lisible
  • Inspecter les événements heartbeat, ack et message complet depuis un backend de push temps réel ou de discussion
  • Convertir des données push SSE capturées en un tableau JSON avant de les partager avec un collègue pour le débogage
  • Extraire et déplier la charge de données imbriquée de chaque événement, sans retirer à la main les préfixes data:
  • Rejouer hors ligne un flux push enregistré et comparer l'ordre des événements par id
  • Préparer des données d'événements SSE pour l'analyse, les journaux ou les tableurs qui attendent un tableau JSON
  • Vérifier qu'un serveur émet bien les noms d'événement et la forme de charge attendus lors de l'intégration frontend-backend
  • Aplanir les champs de données multilignes en une seule valeur analysée par objet d'événement
  • Inspecter les traces SSE provenant de proxys, de passerelles ou d'une sortie curl sous une forme structurée et repliable
  • Convertir en JSON des flux d'événements de type Webhook ou de file de messages qui réutilisent le format de câble SSE
  • Apprendre le format de câble des Server-Sent Events en voyant comment id, event et data se mappent sur des objets JSON

Comment utiliser

  1. Collez le flux SSE brut dans le textarea de gauche, avec les lignes id/event/data et une ligne vide entre les événements
  2. La droite se met à jour automatiquement et affiche un tableau JSON avec un objet par événement
  3. Consultez le panneau d'avertissements si une charge de données n'est pas du JSON valide ou si un champ semble mal formé
  4. Utilisez Copier pour copier l'ensemble du tableau JSON, ou Exemple pour charger d'abord un exemple intégré

Fonctionnalités

  • Convertit un flux d'événements SSE brut en un tableau JSON standard, avec un objet par événement diffusé
  • Regroupe les lignes en événements grâce à la ligne vide, conformément au modèle de distribution des Server-Sent Events
  • Analyse chaque champ sous la forme champ : valeur et retire l'unique espace après le deux-points
  • Analyse chaque charge de données avec JSON.parse afin que les charges imbriquées deviennent de vrais objets, et non des chaînes échappées
  • Conserve un ordre stable des clés id, event et data, et transforme les id numériques en nombres JSON
  • Prend en charge les champs de données multilignes, les lignes de commentaire commençant par un deux-points et les flux sans ligne vide finale
  • Signale les charges de données invalides et les champs inconnus ou mal formés avec les numéros de bloc et de ligne
  • Mise en page avec saisie textarea et aperçu JSON, avec exemple, effacer, copier et statistiques d'événements ; fonctionne entièrement dans le navigateur

SSE vers JSON vs formateur JSONL vs formateur JSON

Ces outils gèrent des formes d'entrée différentes. Choisir le bon évite de retirer à la main des préfixes et d'emballer des tableaux.

OutilForme d'entréeForce principaleQuand l'utiliser
SSE vers JSONBlocs id/event/data séparés par des lignes videsComprend les champs SSE et analyse chaque charge de donnéesFlux push serveur, text/event-stream, blocs en streaming d'IA
Formateur JSONLUn objet JSON complet par ligneValide et formate chaque ligne indépendammentJournaux NDJSON, événements archivés, exports délimités par des lignes
Formateur JSONUn objet ou tableau JSON completEmbellit un seul document JSON entierRéponses d'API, fichiers de configuration, payloads ponctuels

Best Practices

Conservez la ligne vide entre les événements lors de la copie d'un flux

La ligne vide est ce qui sépare un événement SSE du suivant. Si vous retirez les lignes vides en copiant, des événements distincts peuvent se fondre en un seul bloc et la conversion ne correspondra plus à l'ordre de distribution d'origine.

Utilisez les numéros de bloc et de ligne des avertissements pour accéder au problème

Lorsqu'une charge de données échoue à l'analyse, l'avertissement nomme le bloc d'événement et la ligne en cause. Comparez ce bloc avec un événement valide voisin pour repérer une accolade tronquée, un guillemet manquant ou des fragments joints.

N'oubliez que seul le champ data est analysé en JSON

Les champs id, event et retry sont des métadonnées de transport SSE et restent des valeurs scalaires. Ne vous attendez pas à ce que le convertisseur analyse du JSON apparaissant dans le nom d'événement ou l'id ; le contenu structuré appartient à data.

Assemblez les fragments de streaming partiels avant de convertir un message complet

De nombreux flux IA envoient de petits événements STREAM_CHUNK qui construisent un seul message. Convertissez d'abord toute la capture pour voir chaque fragment comme un élément de tableau, puis fusionnez les charges des fragments dans le code de votre application si vous avez besoin du message final.

Nettoyez les charges sensibles avant de partager le JSON converti

La conversion est locale, mais dès que vous copiez le tableau JSON dans un ticket ou une discussion, il quitte votre machine. Retirez les jetons, les identifiants utilisateur et le texte privé de la conversation de la sortie avant de partager.

FAQ

Que sont les SSE (Server-Sent Events) ?

Les SSE sont une façon standard pour un serveur de pousser des événements textuels vers un navigateur via HTTP, en utilisant le type de contenu `text/event-stream`. Chaque événement est constitué de lignes de texte telles que `id`, `event` et `data`, et les événements sont séparés les uns des autres par une ligne vide.

Comment cet outil divise-t-il le flux en événements ?

Il suit le modèle de distribution SSE : l'entrée est découpée en lignes, les lignes non vides consécutives forment un bloc d'événement, et une ligne vide distribue ce bloc comme un nouvel événement. Le dernier bloc sans ligne vide finale est tout de même émis, et les lignes de commentaire commençant par un deux-points sont ignorées.

À quoi ressemble le JSON de sortie ?

Le résultat est un unique tableau JSON. Chaque événement d'entrée devient un objet avec les champs présents, dans l'ordre stable id, event, data. Le texte `data` est analysé avec JSON.parse, si bien qu'une charge telle que `data: {"a":1}` devient un objet imbriqué `"data": {"a":1}` au lieu d'une chaîne échappée.

Pourquoi l'id est-il un nombre dans la sortie ?

Techniquement, les id SSE sont des chaînes, mais les flux push réels utilisent presque toujours des id numériques tels que `id: 0`. Lorsqu'un id ne comporte que des chiffres, le convertisseur l'émet sous forme de nombre JSON ; tout autre id est conservé sous forme de chaîne.

Que se passe-t-il lorsque les données s'étendent sur plusieurs lignes ?

Conformément à la spécification SSE, plusieurs lignes `data:` à l'intérieur d'un même événement sont jointes par un saut de ligne avant d'être analysées comme une seule valeur. Si le texte joint n'est pas du JSON valide, le convertisseur conserve le texte brut et ajoute un avertissement afin que rien ne soit perdu silencieusement.

Que se passe-t-il si une charge de données n'est pas du JSON valide ?

Au lieu de faire échouer toute la conversion, cet événement conserve les données brutes sous forme de chaîne JSON et la page affiche un avertissement avec le numéro de bloc et le message d'erreur de l'analyseur. Les événements valides autour sont quand même convertis normalement.

Quelle différence entre SSE vers JSON et le formateur JSONL ?

JSONL comporte un objet JSON complet sur chaque ligne. SSE a quant à lui des lignes étiquetées `id/event/data` regroupées en événements par des lignes vides, et seule la partie données est du JSON. SSE vers JSON comprend ces étiquettes de champ et les frontières d'événement par ligne vide, là où un formateur JSONL traiterait chaque ligne indépendamment.

Ce convertisseur téléverse-t-il les données de mon flux ?

Non. L'analyse et le formatage s'exécutent entièrement dans votre navigateur, si bien que les données push, les jetons et le contenu des conversations ne quittent jamais votre machine.

Glossaire

SSE
Server-Sent Events, une norme de streaming push unidirectionnel serveur vers client via HTTP.
text/event-stream
Le type MIME du corps d'une réponse SSE, qui contient des lignes de champ séparées par des lignes vides.
Bloc d'événement
Un groupe de lignes de champ consécutives et non vides qui décrivent ensemble un événement diffusé, terminé par une ligne vide.
champ data
Le champ SSE qui porte la charge de l'événement ; plusieurs lignes data dans un même événement sont jointes par un saut de ligne et sont généralement du JSON.
champ event
Le champ optionnel qui nomme le type d'événement ; en son absence, le navigateur le distribue comme l'événement générique « message ».
champ id
La valeur optionnelle last-event-id utilisée pour reprendre un flux ; ce convertisseur émet les id numériques comme des nombres JSON.
champ retry
Un champ optionnel qui indique au client l'attente de reconnexion en millisecondes ; il ne doit contenir que des chiffres ASCII.
Ligne de commentaire
Une ligne commençant par un deux-points, souvent utilisée comme heartbeat ou keep-alive, qui est ignorée lors de la construction des événements.

Authoritative References