View our GitHub

Please visit sails-docs on GitHub to view documentation on your mobile device.

Edit Page


Subscribes a socket to a generic room.


sails.sockets.join(socket, roomName);
Argument Type Details
1 socket -or- The socket to be subscribed. May be specified by the socket's id or a raw socket object.
2 roomName The name of the room to which the socket will be subscribed. If the room does not exist yet, it will be created.


In a controller action:

subscribeToFunRoom: function(req, res) {
  var roomName = req.param('roomName');
  sails.sockets.join(req.socket, roomName);
    message: 'Subscribed to a fun room called '+roomName+'!'

Note: req.socket is only valid if the action is triggered via a socket request, e.g. socket.get('/subscribeToFunRoom/someRoomName')


  • The phrase "request socket" here refers to an application-layer WebSocket/ 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.

Is something missing?

If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.


We wrote a book!

Get early access to the book
with promotion code: mcneildoc

Get the Book