git ssb


dinosaur / http-routes


Michael Williams committed 3.0.1Latest: 054fc2a on 2/8/2017, 4:09:23 AM


functional http router using http-compose and path-to-regexp

npm install --save http-routes


const Server = require('http').createServer
const Cookie = require('cookie')
const Send = require('http-sender')()
const Route = require('http-routes')

const routerHandler = Route([
    // login and set cookies
    ['/login/:id', function login (req, res, context, next) {
      res.setHeader('Set-Cookie', Cookie.serialize('id',, { path: '/' }))
      res.setHeader('Location', '/whoami') // redirect to the whoami page.
      res.statusCode = 303
    // logout and clear cookies
    ['/login', {
      get: function view (req, res, context, next) {
        const newId = Math.random().toString(8).substring(2)
        const html = `<a href='/login/${newId}'>login!</a>`
        res.setHeader('Content-Type', 'text/html')
        next(null, html)
    Route(['/logout', function logout (req, res, context, next) {
      res.setHeader('Set-Cookie', Cookie.serialize('id', '', { path: '/' }))
      res.setHeader('Location', '/whoami') // redirect to the whoami page
      res.statusCode = 303
  // check cookies, and authorize this connection (or not)
  function authorize (req, res, context, next) { = Cookie.parse(req.headers.cookie).id || null
  // return list of the current access rights. (for debugging)
  Route('/whoami', function whoami (req, res, context, next) {
    res.setHeader('Content-Type', 'application/json')

Server((req, res) => {
  routerHandler(req, res, {}, Send(req, res))


Route = require('http-routes')

handler = Route(path, routeHandler(s))

handler = Route([path, routeHandler(s)])

handler = Route([[path, routeHandler(s)], ...])

where path is an Express-style path for path-to-regexp

and handler is a function of shape (req, res, context, next) => { next(err, value) } for http-compose

and routeHandler is a handler where context.params is an object of path matches and context.url is substring of original url after path match

and routeHandlers is an object mapping http method names to route handler functions.


The Apache License

Copyright &copy; 2016 Michael Williams

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Built with git-ssb-web