subscribers.md

.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);
        });
    });