Websockets Connector for Yjs (Client)

With the websockets connector you can set up a central server that saves changes and communicates with clients (see y-websockets-server). This option is very similar to other shared editing frameworks that require a central server. Because the websocket connector is build on top of socket.io, this connector is a rock solid choice if you require high reliability.

• Extremely reliable
• Very easy to use
• Some server load
• You can set up a central server that persists changes
• Falls back to http-communication, if websockets are not supported
• Works with nodejs and in the browser

Use it!

Retrieve this with bower or npm. Note: You need to set up a y-websockets-server that acts as a central server. You should use the default connection endpoint only for testing! If the url property is not set, the default connection endpoint is chosen (provided by the i5 chair of informatics, RTWH University).

NPM

npm install y-websockets-client --save

Bower

bower install y-websockets-client --save

Example

Y({
  db: {
    name: 'memory'
  },
  connector: {
    name: 'websockets-client', // choose the websockets-client connector
    room: 'Textarea-example-dev',
	// socket: http://localhost:1234 // Pass socket object to use
	// url: http://localhost:1234 // the connection endpoint (see y-websockets-server)
	// if `url` is not set, the default connection endpoint is chosen
	// (provided by the i5 chair of informatics, RTWH University)
  },
  sourceDir: '/bower_components', // location of the y-* modules
  share: {
    textarea: 'Text' // y.share.textarea is of type Y.Text
  }
  // types: ['Richtext', 'Array'] // optional list of types you want to import
}).then(function (y) {
  // bind the textarea to a shared text element
  y.share.textarea.bind(document.getElementById('textfield'))
}

License

Yjs is licensed under the MIT License.

[email protected]