hono/README.md

Hono

Hono [炎] - Tiny web framework for Cloudflare Workers and others.

const app = Hono()

app.get('/', () => new Response('Hono!!'))

app.fire()

Feature

• Fast - the router is implemented with Trie-Tree structure.
• Tiny - use only standard API.
• Portable - zero dependencies.
• Optimized for Cloudflare Workers.

Install

$ yarn add hono

or

$ npm install hono

Methods

• app.HTTP_METHOD(path, callback)
• app.all(path, callback)
• app.route(path)
• app.use(path, middleware)

Routing

Basic

app.HTTP_METHOD

// HTTP Methods
app.get('/', () => new Response('GET /'))
app.post('/', () => new Response('POST /'))


// Wildcard
app.get('/wild/*/card', => {
  return new Reponse('GET /wild/*/card')
})

app.all

// Any HTTP methods
app.all('/hello', () => 'ALL Method /hello')

Named Parameter

app.get('/user/:name', (req) => {
  const name = req.params('name')
  ...
})

Regexp

app.get('/post/:date{[0-9]+}/:title{[a-z]+}', (req) => {
  const date = req.params('date')
  const title = req.params('title')
  ...

Chained Route

app
  .route('/api/book')
  .get(() => {...})
  .post(() => {...})
  .put(() => {...})

Middleware

const logger = (req, res, next) => {
  console.log(`[${req.method}] ${req.url}`)
  next()
}

const addHeader = (req, res, next) => {
  next()
  res.headers.add('x-message', 'This is middleware!')
}

app = app.use('*', logger)
app = app.use('/message/*', addHeader)

app.get('/message/hello', () => 'Hello Middleware!')

Request

query

app.get('/search', (req) => {
  const query = req.query('q')
})

params

app.get('/entry/:id', (req) => {
  const id = req.params('id')
})

Related projects

• koa https://github.com/koajs/koa
• express https://github.com/expressjs/express
• itty-router https://github.com/kwhitley/itty-router
• Sunder https://github.com/SunderJS/sunder
• goblin https://github.com/bmf-san/goblin

Author

Yusuke Wada https://github.com/yusukebe

License

MIT