re:re:actable
Урок 071 минута чтения

Что такое Server-Sent Events?

На этой странице
Кратко

Server-Sent Events, или SSE, - механизм, при котором сервер держит HTTP-соединение открытым и отправляет клиенту поток текстовых событий. Клиент слушает события через EventSource.

Вопрос

Что такое Server-Sent Events и чем они отличаются от WebSocket?

Когда SSE лучше WebSocket?

SSE проще, если данные идут только от сервера к клиенту:

  • уведомления;
  • прогресс долгой операции;
  • live-статусы;
  • новостная лента;
  • server logs viewer.

Пример SSE-сервера

import http from 'node:http';
 
http.createServer((req, res) => {
  if (req.url !== '/events') {
    res.statusCode = 404;
    res.end();
    return;
  }
 
  res.writeHead(200, {
    'Content-Type': 'text/event-stream',
    'Cache-Control': 'no-cache',
    Connection: 'keep-alive',
  });
 
  const timer = setInterval(() => {
    res.write(`data: ${new Date().toISOString()}\n\n`);
  }, 1000);
 
  req.on('close', () => {
    clearInterval(timer);
  });
}).listen(3000);

Клиент

const events = new EventSource('/events');
 
events.onmessage = (event) => {
  console.log(event.data);
};

Ограничения

SSE не подходит, если клиенту нужно часто отправлять сообщения по тому же соединению. Тогда лучше WebSocket.

Что важно помнить

  • SSE — односторонний поток событий от сервера к клиенту по обычному HTTP (text/event-stream).
  • EventSource в браузере автоматически переподключается и поддерживает Last-Event-ID.
  • Передаются только текстовые данные; для двустороннего обмена нужен WebSocket.
  • На HTTP/1.1 браузер ограничивает число соединений к домену — HTTP/2 снимает проблему.

Мини-шпаргалка

  • SSE - поток событий от сервера к клиенту.
  • Работает поверх обычного HTTP.
  • Формат события: data: value\n\n.
  • Для двусторонней связи выбирай WebSocket.
  • Не забывай чистить interval при req.close.

Документация

MDN: Server-sent events.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам