Skip to content

Javascript client implementing the RES-Client Protocol.

License

Notifications You must be signed in to change notification settings

resgateio/resclient

Repository files navigation

Resgate logo

ResClient for Javascript
Synchronize Your Clients

License View on NPM Build Status Coverage


Javascript client library implementing the RES-Client Protocol. Used to establish WebSocket connections to Resgate, to get your data synchronized in real-time.

Visit Resgate.io for more information.

Installation

With npm:

npm install resclient

With yarn:

yarn add resclient

Example usage

import ResClient from 'resclient';

const client = new ResClient('ws:https://localhost:8080/ws');

client.get('example.mymodel').then(model => {
    console.log(model.message);

    let onChange = () => {
        console.log("New message: " + model.message);
    };

    // Listen to changes for 5 seconds, eventually unsubscribing
    model.on('change', onChange);
    setTimeout(() => {
        model.off('change', onChange);
    }, 5000);
});

Full examples

Example Description
React React client implementation of the Book Collection example.
Vue.js Vue.js client implementation of the Book Collection example.
Vue 3 Vue 3 client implementation of the Book Collection example.
Modapp Book Collection example from Resgate repository

Note

All examples are complete with both service and client.

Usage in Node.js

To connect with WebSockets in Node.js, we must use a library implementing the WebSocket API, such as isomorphic-ws.

var WebSocket = require('isomorphic-ws');
var ResClient = require('resclient').default;
// Create instance with a WebSocket factory function
var client = new ResClient(() => new WebSocket("ws:https://localhost:8080"));

Documentation

Markdown documentation

About

Javascript client implementing the RES-Client Protocol.

Resources

License

Stars

Watchers

Forks

Packages