Configuration

Settings

HocuspocusProvider

Setting Description Default Value
url The URL of the Hocuspocus/WebSocket server. ''
websocketProvider An instance of HocuspocusProviderWebsocket, if you want to share a socket between multiple providers new HocuspocusProviderWebsocket()
name The name of the document. ''
document The actual Y.js document. Optional, by default a new document is created and be access through provider.document. new Y.Doc()
token An authentication token that will be passed to the server (works with strings, functions and Promises). ''
awareness Awareness object, by default attached to the passed Y.js document. new Awareness()
forceSyncInterval Ask the server every x ms for updates. false

HocuspocusProviderWebsocket

Setting Description Default Value
url The URL of the Hocuspocus/WebSocket server. ''
WebSocketPolyfill Running in Node.js: Pass a WebSocket polyfill, for example ws. WebSocket
timeout A timeout in milliseconds. If timeout is non-zero then a timer is set using setTimeout. If the timeout is triggered then future attempts will be aborted. 0
factor The factor option is used to grow the delay exponentially. 2
maxAttempts The maximum number of attempts or 0 if there is no limit on number of attempts. 0
minDelay minDelay is used to set a lower bound of delay when jitter is enabled. This property has no effect if jitter is disabled. 1000
maxDelay The maxDelay option is used to set an upper bound for the delay when factor is enabled. A value of 0 can be provided if there should be no upper bound when calculating delay. 30000
jitter If jitter is true then the calculated delay will be a random integer value between minDelay and the calculated delay for the current iteration. true
messageReconnectTimeout Closes the connection when after the configured messageReconnectTimeout no message was received. 30000
delay The delay between each attempt in milliseconds. You can provide a factor to have the delay grow exponentially. 1000
initialDelay The initialDelay is the amount of time to wait before making the first attempt. This option should typically be 0 since you typically want the first attempt to happen immediately. 0

Usage

There is not much required to set up the provider, a simple example can be found in Getting started