DocsPricingBlog
Contact Us
Log inSign up for FREE
Back to Tech Articles

Building Real-time Communication in Node.js

Aug 19, 2025
# Misc

Olivia Novak

Dev Intern · Leapcell

This post is also available in 日本語, 한국어, and Deutsch
Cover of "Building Real-time Communication in Node.js"

Introduction

In today's interconnected digital landscape, real-time communication has transitioned from a niche feature to an essential component of modern web applications. From instant messaging platforms that facilitate global conversations to dynamic notification systems that keep users abreast of new information, the ability to exchange data instantaneously is paramount. Traditional HTTP request-response cycles often fall short in delivering this level of immediacy, introducing latency and requiring frequent polling that consumes resources inefficiently. This is where WebSockets step in, providing a persistent, full-duplex communication channel over a single TCP connection. This article will explore how to harness the power of WebSockets in Node.js, using either the lightweight ws library or the robust Socket.IO framework, to build compelling real-time chat and notification services.

Core Concepts for Real-time Communication

Before diving into implementation, let's establish a clear understanding of the core technologies that underpin real-time communication in our context.

WebSockets: WebSockets are a communication protocol that enables two-way interactive communication sessions between a browser and a server. Unlike HTTP, which is stateless and relies on a request-response model, WebSockets establish a persistent connection, allowing both the server and client to send data at any time without the client explicitly requesting it. This makes it ideal for applications requiring low-latency, high-frequency data exchange.

Node.js: A JavaScript runtime built on Chrome's V8 JavaScript engine. Node.js's event-driven, non-blocking I/O model makes it highly efficient for handling numerous concurrent connections, a critical requirement for real-time applications.

ws library: A "plain" WebSocket implementation for Node.js. It's fast, simple, and provides a direct interface to the WebSocket protocol. It's an excellent choice when you need raw WebSocket power without additional layers of abstraction.

Socket.IO: A library that enables real-time, bidirectional, event-based communication. While it primarily uses WebSockets, it provides fallbacks (like long polling) for browsers or environments that don't fully support WebSockets. It also offers features like automatic re-connection, packet buffering, broadcasting, and rooms, simplifying the development of complex real-time applications.

Building Real-time Services with ws

The ws library offers a straightforward path to implementing WebSockets. Let's build a simple chat service using ws.

Server-Side Implementation (ws-server.js)

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', ws => {
  console.log('Client connected');

  ws.on('message', message => {
    console.log(`Received: ${message}`);
    // Broadcast the message to all connected clients
    wss.clients.forEach(client => {
      if (client !== ws && client.readyState === WebSocket.OPEN) {
        client.send(message.toString()); // Ensure message is a string
      }
    });
  });

  ws.on('close', () => {
    console.log('Client disconnected');
  });

  ws.on('error', error => {
    console.error('WebSocket error:', error);
  });

  ws.send('Welcome to the chat!');
});

console.log('WebSocket server started on port 8080');

This server initializes a WebSocket server on port 8080. When a client connects, it logs the connection. Upon receiving a message from a client, it broadcasts that message to all other connected clients, effectively creating a chat room.

Client-Side Implementation (index.html)

<!DOCTYPE html>
<html>
<head>
    <title>WS Chat Client</title>
</head>
<body>
    <h1>WS Chat</h1>
    <div id="messages" style="border: 1px solid black; height: 300px; overflow-y: scroll; padding: 10px;"></div>
    <input type="text" id="messageInput" placeholder="Type your message...">
    <button id="sendButton">Send</button>

    <script>
        const ws = new WebSocket('ws://localhost:8080');
        const messagesDiv = document.getElementById('messages');
        const messageInput = document.getElementById('messageInput');
        const sendButton = document.getElementById('sendButton');

        ws.onopen = () => {
            console.log('Connected to WebSocket server');
        };

        ws.onmessage = event => {
            const messageElement = document.createElement('p');
            messageElement.textContent = event.data;
            messagesDiv.appendChild(messageElement);
            messagesDiv.scrollTop = messagesDiv.scrollHeight; // Scroll to bottom
        };

        ws.onclose = () => {
            console.log('Disconnected from WebSocket server');
        };

        ws.onerror = error => {
            console.error('WebSocket error:', error);
        };

        sendButton.onclick = () => {
            const message = messageInput.value;
            if (message) {
                ws.send(message);
                messageInput.value = '';
            }
        };

        messageInput.addEventListener('keypress', (event) => {
            if (event.key === 'Enter') {
                sendButton.click();
            }
        });
    </script>
</body>
</html>

This client-side code connects to our ws server. It listens for incoming messages and displays them in a div. Users can type messages into an input field and send them to the server.

Building Real-time Services with Socket.IO

Socket.IO builds on WebSockets, offering a higher-level API and additional features.

Server-Side Implementation (socketio-server.js)

First, install Socket.IO: npm install socket.io express

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

const app = express();
const server = http.createServer(app);
const io = socketIo(server);

app.get('/', (req, res) => {
  res.sendFile(__dirname + '/index.html'); // Serve the client HTML
});

io.on('connection', (socket) => {
  console.log('A user connected');

  // Handle chat messages
  socket.on('chat message', (msg) => {
    console.log('message: ' + msg);
    io.emit('chat message', msg); // Broadcast to all
  });

  // Handle notifications
  socket.on('send notification', (data) => {
    console.log('sending notification:', data.message);
    // You could target specific users or rooms here
    io.emit('new notification', { message: data.message, timestamp: new Date() });
  });

  socket.on('disconnect', () => {
    console.log('User disconnected');
  });
});

server.listen(3000, () => {
  console.log('Socket.IO server listening on port 3000');
});

Here, we integrate Socket.IO with an Express server. When a client connects, we attach listeners for custom events like 'chat message' and 'send notification'. The io.emit() function broadcasts messages to all connected clients.

Client-Side Implementation (index.html)

<!DOCTYPE html>
<html>
<head>
    <title>Socket.IO Chat & Notifications</title>
    <script src="/socket.io/socket.io.js"></script>
</head>
<body>
    <h1>Socket.IO Chat</h1>
    <div id="messages" style="border: 1px solid black; height: 200px; overflow-y: scroll; padding: 10px; margin-bottom: 10px;"></div>
    <input type="text" id="chatInput" placeholder="Type your chat message...">
    <button id="sendChatButton">Send Chat</button>

    <h2>Notifications</h2>
    <div id="notifications" style="border: 1px solid black; height: 150px; overflow-y: scroll; padding: 10px; margin-top: 20px;"></div>
    <input type="text" id="notificationInput" placeholder="Type your notification message...">
    <button id="sendNotificationButton">Send Notification</button>

    <script>
        const socket = io(); // Connects to the server where the HTML is served

        const messagesDiv = document.getElementById('messages');
        const chatInput = document.getElementById('chatInput');
        const sendChatButton = document.getElementById('sendChatButton');

        const notificationsDiv = document.getElementById('notifications');
        const notificationInput = document.getElementById('notificationInput');
        const sendNotificationButton = document.getElementById('sendNotificationButton');

        // Handle incoming chat messages
        socket.on('chat message', (msg) => {
            const item = document.createElement('li');
            item.textContent = msg;
            messagesDiv.appendChild(item);
            messagesDiv.scrollTop = messagesDiv.scrollHeight;
        });

        // Handle incoming notifications
        socket.on('new notification', (data) => {
            const item = document.createElement('li');
            item.textContent = `[${new Date(data.timestamp).toLocaleTimeString()}] ${data.message}`;
            notificationsDiv.appendChild(item);
            notificationsDiv.scrollTop = notificationsDiv.scrollHeight;
        });

        sendChatButton.onclick = () => {
            const message = chatInput.value;
            if (message) {
                socket.emit('chat message', message); // Emit 'chat message' event
                chatInput.value = '';
            }
        };

        chatInput.addEventListener('keypress', (event) => {
            if (event.key === 'Enter') {
                sendChatButton.click();
            }
        });

        sendNotificationButton.onclick = () => {
            const notificationMsg = notificationInput.value;
            if (notificationMsg) {
                socket.emit('send notification', { message: notificationMsg }); // Emit 'send notification' event
                notificationInput.value = '';
            }
        };
    </script>
</body>
</html>

The Socket.IO client library (automatically served by Socket.IO) provides the io() function to connect. We listen for 'chat message' and 'new notification' events, displaying them appropriately. socket.emit() is used to send custom events to the server.

Application Scenarios

The power of WebSockets with Node.js extends to numerous real-world applications:

  • Real-time Chat Applications: As demonstrated, instant messaging is a primary use case. Group chats, private messages, and typing indicators all benefit from real-time capabilities.
  • Live Notifications: Delivering immediate alerts for new emails, friend requests, news updates, or system events.
  • Collaborative Tools: Shared whiteboards, co-editing documents, and project management tools where changes need to be reflected instantly across multiple users.
  • Gaming: Real-time multiplayer games where player positions, scores, and actions need to be synchronized with minimal latency.
  • Financial Tickers & Dashboards: Displaying real-time stock prices, cryptocurrency data, or analytics updates.
  • IoT Device Communication: Remotely controlling devices or receiving sensor data instantaneously.

Comparing ws and Socket.IO

Featurews LibrarySocket.IO
ProtocolPure WebSocket implementationUses WebSockets primarily, with long-polling and other fallbacks
Ease of UseSimple, direct API for raw WebSocketsHigher-level API, abstracts away many complexities
FeaturesBasic send/receive, connection managementAutomatic re-connection, packet buffering, broadcasting, rooms, namespaces, custom events, built-in heartbeat mechanism
Browser SupportRequires native WebSocket supportWider browser support due to fallbacks
OverheadMinimal overhead, very lightweightSlightly more overhead due to its feature set
Use CaseWhen you need direct WebSocket control and minimal dependencies, performance-critical applicationsComplex real-time applications requiring robustness, advanced features, and broad compatibility

Conclusion

Building real-time communication into your Node.js applications with WebSockets, whether through the minimalist ws library or the feature-rich Socket.IO, unlocks a new dimension of interactivity and user engagement. Both tools empower developers to create dynamic, responsive web experiences far beyond the capabilities of traditional HTTP. By leveraging these powerful technologies, developers can effectively craft instantaneous chat services, dynamic notification systems, and a multitude of other real-time applications that define modern web interactions.

Share this article

HackerNews

More Posts from Leapcell

cover

One Node.js BFF for All Your Frontend Needs

cover

Streamlining Configuration and Secrets in Node.js Applications with Dotenv and Config

Popular Posts