Simple way to pass config items from server to client
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.
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.
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.
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:
var app = require'express'config = require'getconfig';// our sample request handlerappget'/app'// here we set a cookie called "config" to a JSON encoded settings objectrescookie'config' JSONstringifyconfigclient;// then render the html and respondresrender'app';;applisten80;
sample client usage:
var config = require'clientconfig';console.logconfigapiConnectionUrl; // prints out connection url from server config JSON file
npm i clientconfig
Add it to your clientmodules or user browserify to include it in your app. voila!
If you dig it, follow @HenrikJoreteg on the twitterwebs. If not, file issues or send pull requests :)