Easily integrate Rails ActionCable into your Angular2/4/ionic3 application.

Demo

https://ng2-cable-example.herokuapp.com

https://github.com/viktor-shmigol/ng2-cable-example

https://github.com/viktor-shmigol/ng2-cable-ionic3-example

Blog

How easily integrate Rails' ActionCable into your Angular2/4/ionic2 application

Install

npm install ng2-cable --save

And if we use the SystemJS loader, we would have to add our library to the config.js file like this:

System.config({
    paths: {
      'ng2-cable': 'node_modules/ng2-cable/index.js',
      'actioncable': 'node_modules/actioncable/lib/assets/compiled/action_cable.js'
    }
});

Usage

1. Add Ng2CableModule into your AppModule class. app.module.ts would look like this:

import {NgModule} from '@angular/core';
import { Ng2CableModule } from 'ng2-cable';

@NgModule({
  imports: [Ng2CableModule],
  declarations: [AppComponent],
  bootstrap: [AppComponent],
})
export class AppModule { }

2. app.ts

import { Component } from '@angular/core';
import { Ng2Cable, Broadcaster } from 'ng2-cable';

@Component({
  moduleId: module.id,
  selector: 'sd-app',
  templateUrl: 'app.component.html'
})

export class AppComponent {
  constructor(private ng2cable: Ng2Cable,
              private broadcaster: Broadcaster) {
      this.ng2cable.subscribe('http://example.com/cable', 'ChatChannel', { room: 'My room' });
      //By default event name is 'channel name'. But you can pass from backend field { action: 'MyEventName'}

      this.broadcaster.on<string>('ChatChannel').subscribe(
        message => {
          console.log(message);
        }
      );
    }
  }

API Ng2-cable

.subscribe(url, channel, params)

Method allows to subscribe to a channel.

.unsubscribe()

Method allows to unsubscribe from a channel.

.setCable(url)

Method allows to connect consumer

.actionCable Returns ActionCable.

So you can use it like on rails side:

import { Component } from '@angular/core';
import { Ng2Cable } from 'ng2-cable';

@Component({
  selector: 'sd-app',
  templateUrl: 'app.component.html'
})

export class AppComponent {
  cable:any;
  
  constructor(private ng2cable: Ng2Cable) {
    this.cable = this.ng2cable.actionCable.createConsumer("ws://cable.example.com");
    this.cable.subscriptions.create('ChatChannel', {
      received: (data:any) => {
        console.log('DATA', data)
      }
    });
  }
}

API Broadcaster

.on('Name')

Method allows to subscribe to a event.

.broadcast('event', object)

Method allows to broadcast event.