リアルタイム機能

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

クライアントとサーバー間のリアルタイム双方向通信を実装して、インスタントなデータ同期とライブアップデートを実現します。

使用場面

• チャットおよびメッセージングアプリケーション
• ライブダッシュボードと分析
• 協調編集 (Google Docs スタイル)
• リアルタイム通知
• ライブスポーツスコアまたは株価ティッカー
• マルチプレイヤーゲーム
• ライブオークションまたは入札システム
• IoT デバイス監視
• リアルタイム位置情報追跡

クイックスタート

最小限の動作例:

// server.ts
import WebSocket, { WebSocketServer } from "ws";
import { createServer } from "http";

interface Message {
  type: "join" | "message" | "leave" | "typing";
  userId: string;
  username: string;
  content?: string;
  timestamp: number;
}

interface Client {
  ws: WebSocket;
  userId: string;
  username: string;
  roomId: string;
}

class ChatServer {
  private wss: WebSocketServer;
  private clients: Map<string, Client> = new Map();
  private rooms: Map<string, Set<string>> = new Map();

  constructor(port: number) {
// ... (詳細な実装についてはリファレンスガイドを参照してください)

リファレンスガイド

references/ ディレクトリの詳細な実装:

ガイド	内容
WebSocket Server (Node.js)	WebSocket Server (Node.js)
WebSocket Client (React)	WebSocket Client (React)
Server-Sent Events (SSE)	Server-Sent Events (SSE)
Socket.IO (Production-Ready)	Socket.IO (本番環境対応)

ベストプラクティス

✅ 推奨

• 指数バックオフを伴う再接続ロジックを実装する
• ハートビート/ping-pong を使用してデッド接続を検出する
• すべてのメッセージを検証およびサニタイズする
• 認証と認可を実装する
• 接続制限とレート制限を処理する
• 大きなペイロードに圧縮を使用する
• 適切なエラーハンドリングを実装する
• 接続ヘルスを監視する
• ターゲットメッセージング用にルーム/チャネルを使用する
• グレースフルシャットダウンを実装する

❌ 非推奨

• 暗号化なしで機密データを送信する
• 接続をクリーンアップせずに無期限にオープンに保つ
• ターゲットメッセージングで十分な場合にすべてのユーザーにブロードキャストする
• 接続状態管理を無視する
• 大きなペイロードを頻繁に送信する
• メッセージ検証をスキップする
• モバイル/不安定な接続を忘れる
• スケーリングの考慮を無視する