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

  1. // Controller action
  2. leaveFunRoom: function(req, res) {
  3. var roomName = req.param('roomName');
  4. sails.sockets.leave(req.socket, roomName);
  5. res.json({
  6. message: 'Left a fun room called '+roomName+'!'
  7. });
  8. }

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 ensure req.isSocket == true before using req.socket with this method.