WebSockets & Realtime Systems Programming · レッスン

クライアントへのメッセージブロードキャスト

サーバーから接続中のすべてのクライアント、または特定のクライアントへメッセージを送信する方法を学びます。

「クライアントへのメッセージブロードキャスト」はCoddyKit上の無料WebSockets & Realtime Systems Programmingレッスンです。これはレッスン3/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはWebSockets & Realtime Systems Programming学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 WebSockets & Realtime Systems Programmingコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

What is Broadcasting?

Realtime applications often need to send updates to many users at once. Imagine a live sports score or a chat room.

Broadcasting is when your server sends a single message that is delivered to all currently connected clients.

Why Broadcast Messages?

Broadcasting is a fundamental pattern for many interactive applications:

Live Updates: Stock prices, news alerts, sensor data.
Chat Rooms: New messages visible to all participants.
Notifications: System-wide alerts to all active users.
Multiplayer Games: Player movements, game state changes for all players.

Server's Client List

To broadcast, your WebSocket server needs to know who's connected. The ws library (our Node.js WebSocket server library) automatically keeps track of all active connections.

When a client connects, its WebSocket object is added to an internal list. When it disconnects, it's removed.

Accessing Connected Clients

The ws library exposes the wss.clients property. This is a JavaScript Set containing all currently connected WebSocket client objects.

We can iterate over this Set to send messages to each individual client.

Implementing Full Broadcast

Here's how to modify your server to broadcast any message it receives to all connected clients:

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

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

  ws.on('message', message => {
    // Convert Buffer to string for display/processing
    const msg = message.toString();
    console.log(`Received: ${msg}`);
    
    // Broadcast the received message to all connected clients
    wss.clients.forEach(client => {
      if (client !== ws && client.readyState === WebSocket.OPEN) {
        client.send(`Broadcast: ${msg}`);
      }
    });
    
    // Also send back to the sender as confirmation
    if (ws.readyState === WebSocket.OPEN) {
      ws.send(`You sent: ${msg}`);
    }
  });

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

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

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

Broadcast Code Walkthrough

Let's break down the broadcast logic:

wss.clients.forEach(client => { ... }): This loop goes through every client in the connected set.
if (client !== ws && client.readyState === WebSocket.OPEN): We check if the client is not the sender (to avoid echoing back to them twice) and if their connection is still open.
client.send(`Broadcast: ${msg}`);: This is the magic! It sends the message to that specific client.

Testing the Broadcast

To test this, start your Node.js server. Then, open multiple browser tabs or client applications, all connecting to ws://localhost:8080.

When you send a message from one client, you should see it appear on all other connected clients!

Targeted Messaging

Broadcasting is powerful, but what if you need to send a message to just one or a few specific clients, not everyone?

This is called targeted messaging. Examples include private chat messages, direct user notifications, or status updates for specific admin users.

Identifying Specific Clients

The ws library doesn't inherently give clients unique IDs you can use for targeting. You'll need to implement this yourself:

When a client connects, assign it a unique ID (e.g., a UUID).
Store this ID along with the ws object in a Map or object on your server.
When a client sends a message that requires a targeted response, it can include its ID.

Simple Targeted Example

For a basic example, let's make a server that *only* sends a message back to the client that sent it (a direct echo). This demonstrates sending to a single ws object.

const WebSocket = require('ws');
const wss = new WebSocket.Server({ port: 8081 }); // Use a different port

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

  ws.on('message', message => {
    const msg = message.toString();
    console.log(`Received: ${msg}`);
    
    // Send the message back ONLY to the client that sent it
    if (ws.readyState === WebSocket.OPEN) {
      ws.send(`You said: ${msg}`);
    }
  });

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

  ws.send('Welcome! I will only talk directly to you.');
});

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

Broadcasting Check

You're building a live chat application. When a user sends a message, you want *all* other users in the same chat room to see that message.

Recap & Next Steps

Fantastic work! You've mastered how to send messages from your Node.js WebSocket server:

Broadcasting: Sending a message to all connected clients by looping through wss.clients.
Targeted Messaging: Sending to a specific client using its individual ws object.

These techniques are crucial for building dynamic and interactive realtime applications. Next, we'll dive into how clients connect and interact with these server-side messages!

よくある質問

「クライアントへのメッセージブロードキャスト」レッスンは無料ですか？

はい。「クライアントへのメッセージブロードキャスト」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、WebSockets & Realtime Systems Programmingコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 WebSockets & Realtime Systems Programmingコースには全4レッスンが含まれています。

「クライアントへのメッセージブロードキャスト」で何を学びますか？

サーバーから接続中のすべてのクライアント、または特定のクライアントへメッセージを送信する方法を学びます。ブラウザで直接実行するハンズオンコードでWebSockets & Realtime Systems Programmingを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

WebSockets & Realtime Systems Programmingを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのWebSockets & Realtime Systems Programmingは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン3/4です。

「クライアントへのメッセージブロードキャスト」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このWebSockets & Realtime Systems Programmingレッスンでコードを書いて実行できますか？

はい。すべてのWebSockets & Realtime Systems Programmingレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← WebSockets & Realtime Systems Programmingに戻る