sails.sockets.leave( socket
, roomName
)
Purpose
Unsubscribe a socket from a generic room.
Overview
Parameters
Description | Accepted Data Types | Required ? | |
---|---|---|---|
1 | Socket object | object |
Yes |
2 | Room Name | string |
Yes |
Example Usage
// Controller action
leaveFunRoom: function(req, res) {
var roomName = req.param('roomName');
sails.sockets.leave(req.socket, roomName);
res.json({
message: 'Left a fun room called '+roomName+'!'
});
}
Note: req.socket
is only valid if the action is triggered via a socket request, e.g. socket.get('/leaveFunRoom/someRoomName')
Notes
- The phrase "request socket" here refers to an application-layer WebSocket/Socket.io connection.
req.socket
also exists for HTTP requests, but it refers to the underlying TCP socket at the transport layer, which is different. Be sure and ensurereq.isSocket == true
before usingreq.socket
with this method.