Using bare-mux
Picking a transport
Some examples of transports are EpoxyTransport, CurlTransport, and Bare-Client.
Hosting files
Your files should be statically available from your web server. For this example EpoxyTransport will be hosted at /epoxy/
and bare-mux will be hosted at /baremux/
When using express, all transports and bare-mux provide a path that can be imported into your backend that hosts the static files. An example is shown below.
Starting a connection
The newest version of bare-mux uses SharedWorkers. To initialize bare-mux we have to start a connection. The connection takes the worker path in as a required argument that is needed to proceed with the connection. The
Without using a bundler:
Setting the transport
After your connection is setup, you can call connection.setTransport
to change your transport. The first argument is required and the path to the module version of your transport. For most of them it should be /path/to/transport/index.mjs
, otherwise it should be checked. The second required path is an array that gets interpreted as arguments.
It is recommended to keep your proxy page in an IFrame of the page with the initialized connection, as sometimes the service worker loses connection and needs to contact the page to get a MessagePort
back. If your enviroment is not setup like this, it may cause issues.
Your transport should get set before the service worker is ready, otherwise this may cause a race condition and the transport may not be used for some requests.
If you are moving from bare-mux v1, you can remove your imports of the transports in the page and service worker as bare-mux v2 streamlines the experience to where imports are loaded inside of the SharedWorker. The only time where bare-mux needs to be imported now is when you are making the connection with BareMuxConnection
.
This was written largely by https://github.com/percslol