Util - Codox

forceSync
This call will sync the document state of every collaborator in the session to the same value. 
1
// example use force every collaborators document to become the value of content
2
const content = 'this is the new content'; 
3
codox.forceSync(content)
Copied!
Nominally syncing isn't something you should have to think about when using Codox, however there are some scenarios where you may need to explicitly sync and this is where forceSync could be useful.
One scenario where you might need to use forceSync is if your content management backend supports a versioning system, and front-end users may 'revert' to previous versions from the user-interface. To ensure that other collaborators also revert to the same document version, you should invoke forceSync with the version's document state as the input. An example  flow might look like this:
1
// example handling select document version
2
async function handleVersionSelected(versionId) {
3
​
4
   // call version fetch api 
5
   const docState = await fetchDocumentVersion(versionId);
6
   
7
   // synchronize document state 
8
   codox.forceSync(docState);
9
}
10
​
Copied!
​

Hooks

Error Events

Last modified 1yr ago

Copy link