Why WebSockets enable real-time features in NestJS

Introduction

WebSockets let your app talk back and forth with the server instantly. This helps build features that update right away without waiting.

Chat apps where messages appear instantly

Live sports scores updating without refreshing

Online games needing quick player moves

Real-time notifications like alerts or messages

Collaborative tools where many users edit together

Syntax

NestJS

import { WebSocketGateway, SubscribeMessage, MessageBody, WebSocketServer } from '@nestjs/websockets';
import { Server, Socket } from 'socket.io';

@WebSocketGateway()
export class MyGateway {
  @WebSocketServer()
  server: Server;

  @SubscribeMessage('message')
  handleMessage(@MessageBody() data: string, client: Socket): void {
    this.server.emit('message', data);
  }
}

@WebSocketGateway() marks the class as a WebSocket handler.

@SubscribeMessage('event') listens for messages named 'event'.

Examples

This listens for 'chat' messages and sends the same message back.

NestJS

import { WebSocketGateway, SubscribeMessage, MessageBody } from '@nestjs/websockets';

@WebSocketGateway()
export class ChatGateway {
  @SubscribeMessage('chat')
  onChat(@MessageBody() message: string) {
    return message;
  }
}

This gateway can send 'alert' messages to all connected clients anytime.

NestJS

import { WebSocketGateway, WebSocketServer } from '@nestjs/websockets';
import { Server } from 'socket.io';

@WebSocketGateway()
export class NotifyGateway {
  @WebSocketServer()
  server: Server;

  sendAlert(alert: string) {
    this.server.emit('alert', alert);
  }
}

Sample Program

This simple gateway listens for 'ping' messages and replies with 'pong' plus the sent data. It shows how WebSockets enable instant two-way communication.

NestJS

import { WebSocketGateway, SubscribeMessage, MessageBody, WebSocketServer } from '@nestjs/websockets';
import { Server } from 'socket.io';

@WebSocketGateway()
export class RealTimeGateway {
  @WebSocketServer()
  server: Server;

  @SubscribeMessage('ping')
  handlePing(@MessageBody() data: string) {
    return 'pong: ' + data;
  }
}

Important Notes

WebSockets keep the connection open, so messages flow instantly both ways.

They are better than regular requests when you want live updates without delays.

Summary

WebSockets create a live link between client and server.

This link lets apps update data immediately.

NestJS makes it easy to build WebSocket features with decorators.

Practice

1. Why do WebSockets enable real-time features in a NestJS application?

easy

A. Because they create a persistent connection allowing instant two-way communication

B. Because they use HTTP requests to fetch data periodically

C. Because they store data locally on the client device

D. Because they only send data when the user refreshes the page

Solution

1. Step 1: Understand WebSocket connection type

   WebSockets create a persistent connection between client and server, unlike HTTP which is request-response based.

2. Step 2: Recognize real-time communication benefit

   This persistent connection allows instant two-way communication, enabling real-time data exchange without delays.

3. Final Answer:

   Because they create a persistent connection allowing instant two-way communication -> Option A

4. Quick Check:

   Persistent connection = Real-time communication [OK]

Hint: Remember: WebSockets keep connection open for instant data [OK]

Common Mistakes:

• Thinking WebSockets use periodic HTTP requests
• Confusing local storage with real-time data transfer
• Assuming data sends only on page refresh

2. Which of the following is the correct way to create a WebSocket gateway in NestJS?

easy

A. function createGateway() { return new WebSocket(); }

B. @WebSocketGateway() export class MyGateway {}

C. @GatewaySocket() class MyGateway {}

D. class MyGateway extends WebSocket {}

Solution

1. Step 1: Identify NestJS WebSocket decorator

   In NestJS, the correct decorator to create a WebSocket gateway is @WebSocketGateway().

2. Step 2: Confirm class declaration syntax

   The gateway is defined as a class exported with the decorator, matching @WebSocketGateway() export class MyGateway {}.

3. Final Answer:

   @WebSocketGateway() export class MyGateway {} -> Option B

4. Quick Check:

   Use @WebSocketGateway() for gateways [OK]

Hint: Look for @WebSocketGateway() decorator in NestJS [OK]

Common Mistakes:

• Using incorrect decorator names like @GatewaySocket
• Trying to extend WebSocket directly
• Using plain functions instead of classes

3. Given this NestJS WebSocket gateway code snippet, what will be the output when a client sends a message 'hello'?

@WebSocketGateway()
export class ChatGateway {
  @SubscribeMessage('message')
  handleMessage(client: any, payload: string): string {
    return `Received: ${payload}`;
  }
}

medium

A. The server throws an error because of missing return type

B. The server broadcasts 'hello' to all clients

C. The server sends back 'Received: hello' to the client

D. The server ignores the message and sends nothing

Solution

1. Step 1: Analyze the handleMessage method

   The method listens for 'message' events and returns a string with the payload included.

2. Step 2: Understand return behavior in NestJS WebSocket

   Returning a string sends that string back only to the client who sent the message.

3. Final Answer:

   The server sends back 'Received: hello' to the client -> Option C

4. Quick Check:

   Return string = reply to sender [OK]

Hint: Returned string replies only to sender client [OK]

Common Mistakes:

• Assuming message is broadcast to all clients
• Expecting an error due to missing explicit return type
• Thinking server ignores the message

4. Identify the error in this NestJS WebSocket gateway code:

@WebSocketGateway()
export class MyGateway {
  @SubscribeMessage('chat')
  handleChat(client, payload) {
    client.emit('chat', payload);
  }
}

medium

A. Using client.emit instead of this.server.emit for broadcasting

B. Missing type annotations for client and payload parameters

C. handleChat method should return a value to send response

D. The @SubscribeMessage decorator is misspelled

Solution

1. Step 1: Understand client.emit vs server.emit

   Using client.emit sends message only to that client, but this.server.emit broadcasts to all connected clients.

2. Step 2: Identify intended behavior

   Since the event is 'chat', usually the message should broadcast to all clients, so this.server.emit is correct.

3. Final Answer:

   Using client.emit instead of this.server.emit for broadcasting -> Option A

4. Quick Check:

   Broadcast needs this.server.emit, not client.emit [OK]

Hint: Broadcast uses this.server.emit, not client.emit [OK]

Common Mistakes:

• Confusing client.emit with broadcast emit
• Thinking missing types cause runtime error
• Assuming decorator spelling is wrong

5. You want to build a live sports score update feature using NestJS WebSockets. Which approach best ensures all connected clients receive updates instantly and efficiently?

hard

A. Use client-side timers to simulate score changes without server communication

B. Send HTTP requests every 5 seconds from clients to fetch latest scores

C. Store scores in a database and let clients query on page load only

D. Use a WebSocket gateway with this.server.emit to broadcast score updates to all clients

Solution

1. Step 1: Identify real-time update requirement

   Live sports scores need instant updates pushed to all clients without delay.

2. Step 2: Choose efficient communication method

   Using WebSocket gateway with this.server.emit broadcasts updates instantly to all connected clients efficiently.

3. Final Answer:

   Use a WebSocket gateway with this.server.emit to broadcast score updates to all clients -> Option D

4. Quick Check:

   Broadcast via WebSocket = instant updates [OK]

Hint: Broadcast with this.server.emit for instant updates [OK]

Common Mistakes:

• Using periodic HTTP polling instead of WebSockets
• Relying on client-only timers without server data
• Fetching data only on page load, missing live updates