ngSocketIO

Socket.IO module for AngularJS

Requirements

• AngularJS 1.0.5+
• Socket.IO 0.9.16

Installing

Simply download either ng-socket-io or ng-socket-io.min.js from the build folder and add it to your web application. Just make sure it's included after the AngularJS script.

Usage

1. Add the socket-io module as a dependency in your AngularJS app;
2. Inject the socket factory wherever you need to use Socket.IO;
3. You're done!

Example

<script src="angular.js"></script>
<script src="ng-socket-io.js"></script>
<script>
    var myApp = angular.module('myApp', ['socket-io']);
    myApp.controller('MyCtrl', function($scope, socket) {
        // Listening to an event
        socket.on('someEvent', function(data) {
            $scope.data = data;
        });

        // Raising an event
        $scope.raise = function(message) {
            socket.emit('otherEvent', message);
        };
    });
</script>

Cancelling a subscription automatically on scope destruction

If you want to unsubscribe from an event automatically on scope destruction, just call bindTo passing the current scope:

socket.on('someEvent', function(data) {
...
}).bindTo($scope);

Event Forward Goodness

This package adds to the mbenford/ngSocketIO to include event forwarding from btford/angular-socket-io with the socket.forward method

Provider Implementation

Created as an AngularJS Provider instead of just a Factory allows clients to use app.config(function (socketProvider) { socketProvider.host(…); }) for controlling to what host io.connect(…) is connecting