.subscribers(record,[contexts])
Purpose
Returns an array of sockets that are subscribed to record. This can be used in conjunction with lower-level methods like sails.sockets.emit to send custom messages to a collection of sockets, or with .subscribe to subscribe one group of sockets to a new instance.
| Description | Accepted Data Types | Required ? | |
|---|---|---|---|
| 1 | Record | ((object)), ((integer)), ((string)) | Yes |
| 2 | Contexts to subscribe to | ((string)), ((array)) | No |
Note: record can be either an instance of a model, or a model’s primary key.
context
If you specify a specific context (or array of contexts), you will only get sockets that are subscribed to the specified contexts for the record.
Example Usage
Controller Code
// Find user #1
User.findOne(1).exec(function(e,userOne){
// Get all of the sockets that are subscribed to user #1
var subscribers = User.subscribers(userOne);
// Subscribe them all to userOne's best friend, too
_.each(subscribers, function(subscriber) {
User.subscribe(subscriber, userOne.bestFriendId);
});
});