用途:构建实时应用,如聊天、通知等基于事件的双向通信场景。
主要能力:服务端与客户端事件收发(emit/on)、确认回调与超时、广播(io.emit、socket.broadcast.emit)、房间(join/leave、按房间发送、fetchSockets)、命名空间(io.of)、中间件鉴权、连接与断开事件处理。
安装:服务端 npm install socket.io,客户端 npm install socket.io-client。
使用方式:服务端用 http 服务器或 Express 创建 Server,监听 connection;客户端用 socket.io-client 的 io(url) 连接。资料给出 Next.js Pages Router API Route 的接入示例、React useSocket 自定义 Hook 与聊天组件示例,以及事件、确认回调、广播、房间、命名空间与中间件的代码。
适用场景:需要实时消息推送、群组通信、按房间广播、鉴权的实时功能。
限制:资料未提供收费、价格与平台信息;示例使用 CORS 配置与本地端口,生产环境配置需自行确定。资料还列出最佳实践与常见错误(如未配置 CORS、未清理监听器、阻塞事件循环、缺少错误处理、内存泄漏)及参考文件 references/events.md、references/scaling.md、references/security.md。