Use In a Browser

In each release, a set of browser scripts (regular and minified) are included. To use the library, two scripts must be included in your page. All others are optional (excepting internal dependencies, such as js2p.sync.SyncSocket() relying on js2p.mesh.MeshSocket()).

Your page will look something like:

<head>
    <script type="text/javascript" src="./build/browser-min/js2p-browser-0.6.757-base.min.js"></script>
    <!-- Other js2p loaders here -->
    <script type="text/javascript" src="./build/browser-min/js2p-browser-0.6.757.min.js"></script>
</head>

The two scripts shown are the only required. The library will automatically load any other provided components.

Including these scripts maps the library to the global object js2p. Each component is then mapped to a section of js2p. So in this example, js2p.base would be the only included component.

Caveats

  1. Browsers cannot receive incoming connections. This means that at some point you must connect to a server node. To avoid confusion, a good practice is to provide your addr and port as null.

  2. Browser nodes may only be used with the WebSocket transport layer. This means that you must specify a custom js2p.base.Protocol(), where the second argument is 'ws'.

  3. Scripts must be included in the correct load order. This means that dependencies come first. As of this document’s last update, the preferred order is:

    1. js2p-browser-base.js (required)
    2. js2p-browser-mesh.js
    3. js2p-browser-sync.js and/or js2p-browser-chord.js
    4. js2p-browser.js (required)

Example

This example shows the simple construction of a js2p.sync.SyncSocket(). Note the order of script inclusion.

<!doctype html>
<html>
    <head>
        <script type="text/javascript" src="./build/browser/js2p-browser-0.6.757-base.js"></script>
        <script type="text/javascript" src="./build/browser/js2p-browser-0.6.757-mesh.js"></script>
        <script type="text/javascript" src="./build/browser/js2p-browser-0.6.757-sync.js"></script>
        <script type="text/javascript" src="./build/browser/js2p-browser-0.6.757.js"></script>
    </head>
    <body>
        <script type="text/javascript">
            const socket = new js2p.sync.SyncSocket(null, null, true, new js2p.base.Protocol('chat', 'ws'));
            socket.on('connect', (conn)=>{
                // whatever actions to perform on connection
            });
            socket.connect('example.com', 5555);
            // The rest of your script
        </script>
    </body>
</html>