Session handling

[jcbrand]

The "keepalive" option can be used to instruct Strophe to maintain the current BOSH session across interruptions such as webpage reloads.

It will do this by caching the sessions tokens in sessionStorage, and when connection.restore is called it will check whether there are cached tokens with which it can resume an existing session.

This is how you would use it:

    var connection = new Strophe.Connection(BOSH_SERVICE, {'keepalive': true});
    try {
        connection.restore(jid, callback);
    } catch(e) {
        if (e.name !== "StropheSessionError") { throw(e); }
        # Make ajax call to get new BOSH session tokens and then attach with
        # connection.attach
    }                                                                                                                     

When creating prebound BOSH sessions server-side, it's important to pass in the JID to the connection.restore method. Otherwise one might get sessions restored for the wrong users.

In the manual login case, it's not necessary to pass in the JID.

[jcbrand]

Hi @Gordin, let me know whether you have any suggestions on this feature, otherwise I intend to merge it soon.