objsync's Introduction

ObjSync

Object synchronization between clients via Socket.IO socket-like transports.

Public API

(constructor)(< Socket.IO socket-like >transport, [< object >options])
Creates and returns a new ObjSync object, which communicates via transport.
Valid options:
- delimiter - string - The string to use as delimiter between keys. Default: '.'
- subscribe - bool - Whether the syncer should subscribe to incomming updates. If set to false, no incomming updates will be accepted. Default: 'true'
- publish - bool - Sets whether the syncer should publish updates. If set to false, no updates will be sent. Default: 'false' Note: Two-way syncing can only be done if both sides have equal objects at the time that the connection is made!

Inherits all methods of KVCObject. All updates are automatically (and minimally) synced.

Examples

Client A. Will send updates.

var io = require('socket.io-client');
var ObjSync = require('objsync');

var transport = io.connect('localhost', {port:8888});
var sync = new ObjSync(transport, {subscribe:false, publish:true});

sync.setObject({foo:'bar', person:{name:'johnny'}});

Client B, aka server-side. Will receive updates.

var io = require('socket.io');
var ObjSync = require('objsync');

var transport = io.listen(8888).sockets;
var sync = new ObjSync(transport);

sync.once('update', function (updated) {
    console.dir(updated); // will print { foo: 'bar', 'person.name': 'johnny' }
    console.dir(sync.getObject()); // will print { foo: 'bar', person: { name: 'johnny' } }
});

Recommend Projects