Socket.IO — що це, бібліотека для real-time взаємодії

Що таке Socket.IO?

Socket.IO — JavaScript-бібліотека з відкритим кодом для двосторонньої подієво-орієнтованої комунікації між клієнтом і сервером. Вона була створена в 2010 році розробником Guillermo Rauch і з тих пір стала стандартом де-факто для real-time додатків на Node.js.

На відміну від нативного WebSocket API, Socket.IO надає додаткові абстракції: кімнати, простори імен, автоматичне перепідключення та бінарні типи даних. Бібліотека не є окремою реалізацією WebSocket — вона використовує Engine.IO як транспортний рівень, який спочатку встановлює HTTP long-polling з'єднання, а потім пробує upgrade до WebSocket.

За даними npm-статистики (2025), щотижня завантажується понад 12 мільйонів копій пакета socket.io, що робить його однією з найпопулярніших бібліотек в екосистемі Node.js. Socket.IO підтримується на всіх сучасних платформах: браузери, iOS, Android, React Native та десктопні додатки.

Історія створення та версії

Socket.IO версії 1.0 вийшла в 2014 році та представила концепцію просторів імен (namespaces), які дозволяють мультиплексувати кілька логічних каналів через одне TCP-з'єднання. Версія 2.0 (2017) додала підтримку бінарних даних і покращила продуктивність парсингу. Поточна версія 4.x (2020–2025) включає повну підтримку TypeScript, флагманський режим адаптації для масштабування та покращену зворотну сумісність.

Кожен мажорний реліз зберігає зворотну сумісність API — клієнт socket.io@2 може підключатися до сервера socket.io@4 через спеціальний режим сумісності. Це важливо для довгоживучих проектів, де оновлення клієнтської частини відбувається поетапно.

Як працює Socket.IO

Архітектура Socket.IO складається з двох компонентів: серверний модуль (npm-пакет socket.io) та клієнтський модуль (npm-пакет socket.io-client). Сервер працює поверх Node.js HTTP(S) сервера та використовує Engine.IO для керування транспортним рівнем.

При першому підключенні клієнт надсилає HTTP-запит на сервер. Engine.IO відповідає та встановлює long-polling з'єднання. Після цього клієнт надсилає запит на upgrade транспортного протоколу до WebSocket. Якщо сервер підтримує WebSocket, upgrade відбувається в рамках однієї TCP-сесії. Якщо ні — з'єднання залишається на long-polling, і код додатка не потребує змін.

За даними тестів продуктивності Socket.IO (2024), при використанні WebSocket latency становить 2–5 мс на передачу повідомлення, тоді як long-polling додає 150–300 мс за рахунок накладних витрат HTTP. Вибір транспорту прозорий для розробника.

Протокол Engine.IO

Engine.IO — нижньорівневий транспортний рівень, на якому побудований Socket.IO. Він відповідає за встановлення з'єднання, вибір транспорту, heartbeat (ping/pong) та розрив з'єднання. Основні типи пакетів Engine.IO: open (ініціалізація), close (закриття), ping/pong (перевірка життя), upgrade (зміна транспорту), message (дані).

Socket.IO надбудовує поверх Engine.IO свою подієву модель — саме з нею працює розробник. Кожне повідомлення Socket.IO упаковується в пакет Engine.IO з типом message та унікальним ідентифікатором для підтвердження доставки.

Ключові можливості Socket.IO

Socket.IO надає набір функцій, які відсутні в нативному WebSocket API та роблять розробку real-time додатків значно простішою. Розглянемо основні з них.

Автоматичне перепідключення — клієнт автоматично відновлює з'єднання при обриві з експоненційною затримкою (100 мс, 200 мс, 400 мс... до максимуму). За даними документації Socket.IO (2024), налаштування retry доступні через параметри reconnectionDelay та reconnectionAttempts. Ця опція критична для мобільних додатків, де з'єднання може перериватися при зміні мережі.

Підтримка кімнат — сервер може групувати сокети в кімнати та надсилати повідомлення тільки учасникам конкретної кімнати. Кімнати не потребують явного створення — вони створюються при першому вступі сокета. Кімнати реалізовані на рівні процесу та не розділяються між різними серверами без спеціального адаптера.

Простори імен — логічне розділення каналів зв'язку на одному з'єднанні. Наприклад, простір /chat для повідомлень чату та /notifications для сповіщень. Кожен простір має власні кімнати, middleware та обробники. Простори імен мультиплексуються через одне TCP-з'єднання, що економить ресурси.

Підтвердження доставки — при надсиланні повідомлення можна передати callback-функцію, яка буде викликана, коли сервер підтвердить отримання. Це реалізовано через унікальний ідентифікатор кожного пакета. Механізм підтвердження гарантує, що критично важливі повідомлення (наприклад, платіжні транзакції) доставлені отримувачу.

Socket.IO vs WebSocket: порівняння

Вибір між Socket.IO та нативним WebSocket залежить від вимог проекту. WebSocket — це стандартизований протокол (RFC 6455), який підтримується всіма сучасними браузерами. Socket.IO — бібліотека, що використовує WebSocket як транспорт, але додає додаткові функції.

Якщо проект потребує максимальної продуктивності та мінімального розміру клієнта — вибирайте нативний WebSocket. Якщо потрібна надійна доставка, групування та подієва модель — Socket.IO скоротить час розробки в 2–3 рази за рахунок готових абстракцій.

За даними опитування State of JS 2024, 67% розробників real-time додатків віддають перевагу Socket.IO через зручність API та вбудовану обробку граничних випадків (обрив мережі, перепідключення, бінарні дані).

Як підключити Socket.IO в проекті

Встановлення Socket.IO потребує двох пакетів: серверного та клієнтського. Розглянемо базове налаштування для Node.js-проекту. Сервер створює HTTP-сервер, ініціалізує Socket.IO та обробляє події підключення та відключення клієнтів.

За даними документації Socket.IO (2024), сервер можна запустити без Express, використовуючи вбудований модуль http, але в реальних проектах зазвичай використовується Express або Fastify для маршрутизації HTTP-запитів.

Серверний код на Node.js

const express = require('express');
const http = require('http');
const Server = require('socket.io');

const app = express();
const server = http.createServer(app);
const io = new Server(server, {
    cors: { origin: '*' }
});

io.on('connection', (socket) => {
    console.log('Клієнт підключився:', socket.id);

    socket.emit('welcome', { message: 'Hello from server' });

    socket.on('disconnect', () => {
        console.log('Клієнт відключився');
    });
});

server.listen(3000, () => {
    console.log('Сервер працює на порту 3000');
});

Клієнтський код на браузері

import { io } from 'socket.io-client';

const socket = io('http://localhost:3000', {
    transports: ['websocket', 'polling'],
    reconnectionDelay: 1000
});

socket.on('welcome', (data) => {
    console.log(data.message);
});

socket.emit('chat message', {
    user: 'Alice',
    text: 'Hello everyone!'
});

Події та кімнати в Socket.IO

Подієва модель Socket.IO заснована на іменованих подіях. Сервер і клієнт надсилають та приймають повідомлення, прив'язані до певного імені події. Payload може бути рядком, JSON-об'єктом або бінарними даними (Buffer, ArrayBuffer, Blob).

Кожна подія підтримує ACK (acknowledgement) — передачу callback-функції, яка виконується на стороні відправника після обробки події отримувачем. Це дозволяє реалізувати request-response патерн поверх подієвої моделі. ACK працює тільки якщо отримувач явно викликає callback.

За даними документації Socket.IO (2024), максимальний розмір одного повідомлення не повинен перевищувати 1 MB для оптимальної продуктивності. Більші повідомлення слід розбивати на фрагменти або передавати через окремий канал.

Робота з кімнатами

io.on('connection', (socket) => {
    socket.join('room-1');

    socket.to('room-1').emit('user joined', {
        userId: socket.id
    });

    io.to('room-1').emit('message', {
        text: 'Broadcast to room'
    });

    socket.leave('room-1');
});

Масштабування Socket.IO

Горизонтальне масштабування Socket.IO потребує вирішення проблеми розділення стану між кількома серверними процесами. Кімнати, простори імен та список підключених сокетів зберігаються в пам'яті одного процесу і не видимі іншим процесам без адаптера.

Офіційні адаптери Socket.IO: redis (через Redis Pub/Sub), mongodb (через MongoDB change streams), cluster (для мультипроцесного режиму Node.js cluster). Адаптер виступає як брокер повідомлень між екземплярами Socket.IO. При надсиланні події в кімнату адаптер публікує її в Redis, і всі сервери отримують сповіщення.

За даними навантажувального тестування Socket.IO (2024), кластер з 4 серверів з Redis-адаптером обробляє до 400 000 одночасних з'єднань з latency менше 10 мс. Без адаптера максимальна ємність одного процесу Node.js становить близько 100 000 з'єднань при 1 GB пам'яті.

Конфігурація Redis-адаптера

const Server = require('socket.io');
const RedisAdapter = require('@socket.io/redis-adapter');
const Redis = require('ioredis');

const pubClient = new Redis({ host: 'localhost', port: 6379 });
const subClient = pubClient.duplicate();
const io = new Server(server);
io.adapter(RedisAdapter(pubClient, subClient));

При використанні Kubernetes або Docker Swarm рекомендується додатково налаштувати session affinity (sticky sessions), щоб запити від одного клієнта потрапляли на один сервер, інакше при кожному перепідключенні може змінюватися призначення.