Itty Router is a lightweight, zero-dependency router for JavaScript projects, particularly suited for serverless and edge computing environments. It offers a simple and intuitive API for handling routing in applications, with a focus on minimalism and performance.

Pros

• Extremely lightweight (less than 400 bytes minified + gzipped)
• Zero dependencies, reducing potential security vulnerabilities
• Simple and intuitive API for easy integration
• Supports nested routers for modular code organization

Cons

• Limited built-in features compared to more comprehensive routing libraries
• May require additional middleware or plugins for advanced use cases
• Not as widely adopted as some other routing solutions
• Documentation could be more extensive for complex scenarios

Code Examples

Basic routing:

import { Router } from 'itty-router'

const router = Router()

router.get('/hello', () => new Response('Hello, World!'))
router.get('/user/:id', ({ params }) => new Response(`User ID: ${params.id}`))

router.all('*', () => new Response('Not Found', { status: 404 }))

// Handle requests
addEventListener('fetch', event => {
  event.respondWith(router.handle(event.request))
})

Nested routers:

import { Router } from 'itty-router'

const router = Router()
const apiRouter = Router({ base: '/api' })

apiRouter.get('/users', () => new Response('List of users'))
apiRouter.post('/users', () => new Response('Create user'))

router.all('/api/*', apiRouter.handle)

// Handle requests
addEventListener('fetch', event => {
  event.respondWith(router.handle(event.request))
})

Using middleware:

import { Router } from 'itty-router'

const router = Router()

const authMiddleware = (request) => {
  if (!request.headers.get('Authorization')) {
    return new Response('Unauthorized', { status: 401 })
  }
}

router.get('/protected', authMiddleware, () => new Response('Protected content'))

// Handle requests
addEventListener('fetch', event => {
  event.respondWith(router.handle(event.request))
})

Getting Started

1. Install the package:

   npm install itty-router
   

2. Create a new router and define routes:

   import { Router } from 'itty-router'
   
   const router = Router()
   
   router.get('/', () => new Response('Home page'))
   router.get('/about', () => new Response('About page'))
   
   // Handle requests
   addEventListener('fetch', event => {
     event.respondWith(router.handle(event.request))
   })
   

3. Use the router in your serverless or edge computing environment (e.g., Cloudflare Workers, Deno Deploy, etc.).