Communication between levels¶
The communication is done using
wwww/common/outer/worker-channel.js, a mini-library developed in CryptPad. This library allows two systems to send "query" and "event" messages to each other. A "query" consists of sending data and waiting for a response, while an "event" is just sending data.
This library automatically manages callbacks for received answers and allows each party to indicate when it is ready to communicate. The way messages are sent is managed outside the library thanks to a
sendMessage function that is provided as an argument. If it is a query, a callback is included with the data.
Communication with inner¶
Two steps take place in parallel:
loading the user account in the worker
loading the application interface in the inner iframe
Once the user account is loaded,
sframe-common-outer initializes all its "handlers" which manage the events and queries received from "inner". There are many such "handlers" which can be found in the code by searching for
sframeChan.on('...', handler);. They are notably used to:
Execute functions related to the "outer" level
Change the title of the tab or its icon
Modify the localStorage or modify theStorage session
Execute functions related to the keys of the document
Change the document password (requires decrypting and re-encrypting the entire content)
Save or modify the pad data in the drive (the URL of the pad is stored in the drive)
Make a copy or make a template of the document (requires access to the decrypted content to re-encrypt it differently)
Transfer commands to the worker
Access to more data
Join a document in order to send and receive patches
Document management actions (rename, delete, access list, owners, etc.)
Transfer commands to the worker's modules
These commands usually only pass through here, they are not read and are sent directly to the worker
Once all these "handlers" have been registered,
sframe-common-outer declares itself "ready" and, once "inner" declares the same, the script starts the realtime engine (if necessary) creating a new document or joining an existing one.
Communication with the worker¶
The main role of this file is to create a communication channel with the worker and to initialize it for the user account. The keys of the account have been extracted from the localStorage beforehand. Once the user account and all the modules are loaded, the worker sends a signal to cryptpad-common which allows the sframe-common-outer script to continue.
Apart from this user account loading process,
cryptpad-common keeps a privileged contact with the worker. This allows it to perform some tasks specific to the current tab but which require access to the worker's data.