Client-side router in the spirit of Express, for mock data, development and demos.


Client-side router in the spirit of Express for mock data, development and demos.

Set up a ghosttrain instance

var ghosttrain = new GhostTrain();

Set up routes

var users = {
  '1': {
    name: 'Ozzie Isaacs',
    skills: ['Planet Riding']
ghosttrain.get('/users/:id', function (reqres) {
  res.request(200, users[]);
ghosttrain.request('GET', '/users/12345', function (errresbody) {
  // { name: 'Ozzie Isaacs', skills: ['Planet Riding'] } 
  // 200 

Makes a request to the GhostTrain instance's router. Takes an HTTP method, path, optional options object, and a callback accepting an err, res and body in its arguments.

Possible options are:

  • delay- Number of ms to wait before executing routing (default: 1)
  • body- Object representing POST body data (default: {})
  • headers- Object of pairings of header values (default: {})
  • contentType- Sets headers for Content-Type

Sets a setting value, similar to Express's app.set. The application settings currently supported are:

  • case sensitive routing
  • strict routing
  • json replacer
  • json spaces

Gets a setting value, similar to Express's app.get.

Sets a setting value to true, similar to Express's app.enable

Sets a setting value to false, similar to Express's app.disable

Creates a route; VERB can be get, post, put, or delete, similar to Express's app.verb.

The request object is passed into the route callback as the first argument. Much of the API attempts to mimic Express's request.

Contains an array of mapped route "parameters", like Express's req.params.

Is an object containing the parsed request body, like Express's req.body.

Send a response; has the same API as Express's res.send.

Send a JSON response; same API as Express's res.json.

Sets the response status code to code, similar to Express's res.status.

GhostTrain has been tested on latest versions of Firefox, Chrome, Safari, Opera, and IE8+. For IE8 support, several polyfills and APIs must be implemented; you can use the ./dist/ghosttrain-legacy.js build which contains all these polyfills, or implement them on your own. The methods needed are:

  • Array.prototype.indexOf
  • Array.prototype.forEach
  • Array.isArray
  • String.prototype.trim
  • Object.keys
  • JSON.parse
  • JSON.stringify