Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Simple Socket.IO module for AngularJS
JavaScript
Branch: master

README.md

ngSocketIO

Build Status

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);
Something went wrong with that request. Please try again.