Socket.io 是一个基于 Node.js 的实时应用程序框架，提供了一套简单易用的 API，用于在客户端和服务端之间建立实时、双向的通信。本文将详细介绍 Socket.io 的 API，包括连接、事件、房间、命名空间等方面的内容，旨在帮助前端开发者更好地理解和使用 Socket.io。
连接
要使用 Socket.io，首先需要在客户端和服务端分别引入 Socket.io 库。在客户端，可以通过以下代码引入：
<script src="/socket.io/socket.io.js"></script>
在服务端，则需要使用 require 函数引入：
const io = require('socket.io')(server);其中，server 是一个 Node.js 的 HTTP 服务器实例。创建 Socket.io 实例后，可以通过 io.on 方法监听 connection 事件，当客户端与服务端建立连接时，该事件将被触发。
io.on('connection', (socket) => {
console.log('a user connected');
});在 connection 事件回调函数中，可以获取到一个 socket 对象，该对象代表当前连接的客户端。通过 socket.emit 方法可以向客户端发送消息，而通过 socket.on 方法可以监听客户端发送的消息。
socket.on('message', (data) => {
console.log('received message:', data);
socket.emit('message', 'hello client');
});事件
Socket.io 支持自定义事件，可以通过 socket.emit 方法向客户端发送事件，也可以通过 socket.on 方法监听客户端发送的事件。事件名称可以是任意字符串，但建议使用语义化的名称。
socket.on('login', (username) => {
console.log(`${username} logged in`);
});
socket.emit('message', 'hello client');在事件回调函数中，可以获取到客户端发送的参数。如果需要向多个客户端发送事件，可以使用 io.emit 方法，该方法将事件广播给所有连接的客户端。
io.emit('message', 'hello everyone');房间
Socket.io 支持将客户端分组到不同的房间中，以便对特定用户群体进行广播。可以通过 socket.join 方法将客户端加入房间，通过 socket.leave 方法将客户端移除房间。在房间内广播事件时，可以使用 io.to 方法指定房间名称。
socket.join('room1');
socket.emit('message', 'you joined room1');
io.to('room1').emit('message', 'hello room1');在事件回调函数中，可以通过 socket.rooms 属性获取客户端所在的房间列表。如果需要向所有房间广播事件，可以使用 io.emit 方法。
console.log(socket.rooms); // ['room1']
io.emit('message', 'hello everyone');命名空间
Socket.io 支持将不同类型的事件分组到不同的命名空间中，以便更好地管理事件。可以通过 io.of 方法创建命名空间，通过 socket.on 方法监听命名空间内的事件。
-- -------------------- ---- -------
----- ------------- - ---------------
------------------------------ -------- -- -
-------------- ---- --------- -- ---- ------------
-------------------- ------ -- -
--------------------- ------- -- ---- ------------ ------
----------------------------- ------ -------- -- ---- ------------
---
---在客户端，可以使用 io.connect 方法连接指定的命名空间，通过 socket.emit 方法向命名空间发送事件。
const socket = io.connect('/chat');
socket.on('message', (data) => {
console.log('received message in chat namespace:', data);
});
socket.emit('message', 'hello chat namespace');总结
Socket.io 提供了一套简单易用的 API，用于在客户端和服务端之间建立实时、双向的通信。本文介绍了 Socket.io 的连接、事件、房间、命名空间等方面的内容，并提供了示例代码。希望本文能够帮助前端开发者更好地理解和使用 Socket.io，从而为实时应用程序的开发提供便利。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/65fcdb99d10417a2228397d6