Notorious Pug Mafia


    0.9.0 • Public • Published


    This package provides some utilities to complement Node's HTTP server.

    Shipped like an ES module


    import { createServer } from 'http'
    import { createRouter } from '@nicolasparada/httptools'
    const router = createRouter()
    router.handle('GET', '/', (req, res) => {
        res.end('Hello there 🙂')
    const server = createServer(router.handler)
    server.listen(3000, '', () => {
        console.log('Server running at http://localhost:3000 🚀')

    You can register HTTP handlers for a given HTTP verb and URL pattern.

    Pattern Matching and Context

    import { contextFor, pattern } from '@nicolasparada/httptools'
    router.handle('GET', pattern`/hello/{name}`, (req, res) => {
        const ctx = contextFor(req)
        const params = ctx.get('params')
        res.end(`Hello, ${}!`)

    You can create dynamic routes by passing a regular expression. pattern() is a tagged template literal function that converts the given pattern into a regular expression for simplicity. In this example, it's equivalent to /^\/hello\/(?<name>[^\/]+)$/.

    You can capture parameters from the URL with a curly braces syntax as shown there. You can also use a wilcard * to capture anything.

    Inside the request context, you'll find a "params" object with all the URL parameters. Context can be filled with your own data. See middleware down below. I do that to not mess with the Node.js API.


    router.handle('GET', '/auth_user', withAuthUser(authUserHandler))
    function withAuthUser(next) {
        return (req, res) => {
            const token = extractToken(req)
            const authUser = decodeToken(token)
            const ctx = contextFor(req)
            ctx.set('auth_user', authUser)
            return next(req, res)
    function authUserHandler(req, res) {
        const ctx = contextFor(req)
        const authUser = ctx.get('auth_user')
        res.setHeader('Content-Type', 'application/json; charset=utf-8')

    contextFor() will give you a WeakMap in which you can save data scoped to the request. Just use function composition for middleware.


    import { createRouter, pattern, stripPrefix } from '@nicolasparada/httptools'
    const api = createRouter()
    api.handle('GET', '/', handler)
    const router = createRouter()
    router.handle('*', pattern`/api/*`, stripPrefix('/api', api.handler))

    stripPrefix() is a middleware that trims the given prefix from the request URL. That way, you can compose multiple routers.



    npm i @nicolasparada/httptools

    DownloadsWeekly Downloads






    Unpacked Size

    8.12 kB

    Total Files


    Last publish


    • nicolasparada