Cookieless.js
Cookieless user tracking for node.js
Cookieless.js is a lightweight implementation of visitor's tracking using ETag for Node.js. It may be used on its own or along side other tracking methods (cookies or browser fingerprinting), so whenever one solution fails, you may fallback to a back up one.
Read more about ETag here.
This package allows you to use the visitor's information both server side and client side by providing a JSONP API.
Install
npm install cookieless --save
Tests
npm test
Example
Server side
The following example starts a tracking beacon at: http://127.0.0.1/i.js?callback=setVisitor
var CookielessTracker = ; /*Note: it's not mandatory to start a beacon, you may handle the requests yourself and just use the tracker's API*/CookielessTracker;
Client side (browser)
$;
API
(static) startBeacon(port=7123, host='0.0.0.0', onVisitorCallback)
The easiest way of hit the ground running is by using the built-in lightweight beacon, which starts a listener and processes the tracking requests. If a onVisitorCallback function is given, it will be called everytime a visitor calls the endpoint.
var CookielessTracker = ;CookielessTracker;
The endpoint will be available at http://127.0.0.1/i.js?callback=setVisitor and the response will be:
; typeof setVisitor === 'function' && ;
Contructor(request, update=true)
Initializes a new visitor (may be returning visitor) from a request. If it is a new visitor it will automatically generate a new unique ETag.
If update is set to true, it will automatcally update the visitor's session if they were last seen over 30 minutes ago. (Otherwise you'll have to manually call the update API).
var CookielessTracker = ; http;
respond([callback,] res)
Given a response object, it will build and send a JSONP response to the visitor with the callback function name (if given). It is a combination of statusCode(), buildHeader(), and buildScript(). (Important: the callback function name should be set and never changed, otherwise the tracking will be reset)
http;
buildScript([callback])
Builds the JSONP script with the visitor's information, the callback argument is a string with name of the callback function for the JSONP response. (If the request has a callback set in the query string, it will be the default value)
console;//Outputs://; typeof setVisitor === 'function' && setVisitor({id: 31428830410917,session: 3,lastSeen: 1428830410917});
buildHeader()
Builds the header for the response including the identifier ETag.
//Output: 'Content-Type': 'text/javascript' 'ETag': "31428830410917.1428830410917.3"
statusCode()
It gives the most appropriate status code for a tracking response. The response only changes when the session number gets updated, in that case the stattus will be 200, any other case should return 304.
var visitor = req;res;