Skip to content
Super simple clientmodule for passing config items, such as API connection URLs, debug modes, etc from server to client.
JavaScript
Find file
Latest commit 91353b0 Dec 4, 2015 @HenrikJoreteg 1.1.1
Failed to load latest commit information.
test Add unit tests Sep 22, 2015
.gitignore better readme Jun 4, 2013
.jshintignore Default config object to an empty object if no cookie is available Jun 24, 2013
.jshintrc Add jshint Sep 22, 2015
LICENSE
README.md
build.js including built standalone file Jun 19, 2013
clientconfig.bundle.js Update bundled dependencies Sep 22, 2015
clientconfig.js Default config object to an empty object if no cookie is available Jun 24, 2013
package.json 1.1.1 Dec 4, 2015

README.md

clientconfig

Super simple mechanism for passing config items, such as API connection URLs, debug modes, etc from the server to client.

This is handy for apps built as single page apps where you're sending a pre-built js application to the client but still want to be able to pass it configuration information.

This is a very simple client side module for browserify. For more info on the approaches used here check out humanjavascript.com.

If you want to use it as a standalone, or with AMD etc. You can use clientconfig.bundle.js. It has no dependencies.

Since we're using cookies, here are some pertinent warnings as so aptly put by @lauriro here:

Unless sent over a secure channel (such as HTTPS), the information in cookies is transmitted in the clear text.

All sensitive information conveyed in these headers is exposed to an eavesdropper. A malicious intermediary could alter the headers as they travel in either direction, with unpredictable results. A malicious client could alter the Cookie header before transmission, with unpredictable results.

In short, don't send sensitive info this way unless you're on https.

How does it work?

Clientconfig simply looks for a cookie named config parses it as JSON and immediately wipes it out to avoid burdening subsequent requests with that extra overhead.

How do I use it?

On the server-side when serving up your request set a cookie containing the values you'd like to pass to the client in JSON.

If you're using node.js, express and getconfig it'd work like this:

sample config file:

{
    "client": {
        "apiConnectionUrl": "https://dev.api.com",
        "debugMode": true,
        "enviroment": "dev"
    },
    "otherServerConfigItems": {
        "dbpasswords": "etc"
    }
}

sample server:

var app = require('express')(),
    config = require('getconfig');

// our sample request handler
app.get('/app', function (req, res) {
    // here we set a cookie called "config" to a JSON encoded settings object
    res.cookie('config', JSON.stringify(config.client));
    // then render the html and respond
    res.render('app');
});

app.listen(80);

sample client usage:

var config = require('clientconfig');

console.log(config.apiConnectionUrl); // prints out connection url from server config JSON file

Installing

npm i clientconfig

Add it to your clientmodules or user browserify to include it in your app. voila!

Feedback

If you dig it, follow @HenrikJoreteg on the twitterwebs. If not, file issues or send pull requests :)

License

MIT

Something went wrong with that request. Please try again.