SSE : le serveur vous tient au courant

Ce que vous saurez faire

Lire un événement SSE, distinguer reconnexion et reprise métier, puis prévoir le nettoyage du client. Un flux texte simple peut suffire à un suivi de tâche.

1. Le serveur envoie des événements délimités

La réponse utilise le type text/event-stream et reste ouverte. Chaque événement se termine par une ligne vide. Voici un événement que votre serveur de test pourrait émettre :

id: 17
event: progress
data: {"percent":60}

La ligne vide finale délimite l’événement. event choisit son nom ; data contient le texte à interpréter. Plusieurs lignes data d’un même événement sont réunies avec des sauts de ligne. Un commentaire commençant par : peut entretenir l’activité du flux, sans devenir un événement métier.

// Nécessite un serveur SSE exposant /events.
const stream = new EventSource('/events');
stream.addEventListener('progress', (event) => {
  try {
    const payload = JSON.parse(event.data);
    if (!Number.isFinite(payload?.percent) ||
        payload.percent < 0 || payload.percent > 100) return;
    console.log('Progression :', payload.percent);
  } catch {
    console.warn('Événement ignoré');
  }
});
// Quand l’écran n’a plus besoin du flux : stream.close();

Un événement nommé progress demande cet écouteur spécifique ; onmessage vise les événements sans nom personnalisé.

Référence : utiliser SSE.

2. Un identifiant ne recrée pas les événements perdus

Lors d’une reconnexion automatique, EventSource peut transmettre le dernier identifiant dans Last-Event-ID. Le serveur doit savoir quoi en faire : conserver un historique, retrouver la position et reprendre après elle. Sans cette logique, l’identifiant n’offre pas de garantie de rattrapage.

Si l’historique a expiré, définissez une réponse applicative explicite : par exemple un événement invitant le client à recharger l’état complet. Définissez aussi la gestion des doublons. Afficher « 60 % » deux fois ne pose pas le même problème qu’ajouter deux fois une ligne dans un journal.

Testez le chemin réel via votre proxy : une réponse peut être mise en tampon et arriver par paquets au lieu d’être diffusée immédiatement.

Référence : EventSource et reconnexion.

À vous de jouer

Le dernier identifiant reçu est 17, mais le serveur ne conserve plus que les événements 25 à 40. Peut-il garantir une reprise complète en envoyant 25 ?

Correction commentée

Non : les événements 18 à 24 manquent. Il faut recharger un état de référence ou indiquer explicitement la lacune. La reconnexion du transport fonctionne, mais la continuité des données n’est pas assurée automatiquement.