hono 4.1.0 on Node.js NPM

Hono v4.1.0 is now available! Let's take a look at the new features.

WebSocket Helper

Now Hono supports WebSockets! With WebSocket helper, you can easily handle WebSockets in your application. Currently, Cloudflare Workers / Pages, Deno, and Bun adapters are available.

const app = new Hono()

app.get(
  '/ws',
  upgradeWebSocket((c) => {
    return {
      onMessage(event, ws) {
        console.log(`Message from client: ${event.data}`)
        ws.send('Hello from server!')
      },
      onClose: () => {
        console.log('Connection closed')
      }
    }
  })
)

PRC mode is now also supported for WebSockets endpoints. The following is a demo.

Thanks @nakasyou!

Body Limit Middleware

Introducing Body Limit Middleware. This middleware can limit the file size of the request body.

const app = new Hono()

app.post(
  '/upload',
  bodyLimit({
    maxSize: 50 * 1024, // 50kb
    onError: (c) => {
      return c.text('overflow :(', 413)
    }
  }),
  async (c) => {
    const body = await c.req.parseBody()
    if (body['file'] instanceof File) {
      console.log(`Got file sized: ${body['file'].size}`)
    }
    return c.text('pass :)')
  }
)

Thanks @EdamAme-x and @usualoma!

ES2022

We made the target in the tsconfig.json as ES2022 instead of ES2020. So, the generated JavaScript files are now ES2022. That made the file size smaller! The following is the result of the minify and build of "Hello World" with Wrangler.

// ES2020
hono => Total Upload: 20.15 KiB / gzip: 7.42 KiB
hono/tiny => Total Upload: 12.74 KiB / gzip: 4.69 KiB

// ES2022
hono => Total Upload: 18.46 KiB / gzip: 7.09 KiB
hono/tiny => Total Upload: 11.12 KiB / gzip: 4.38 KiB

Performance has also been improved in some Node.js environments.

Other features

Cookie Helper - Supports __Secure- and __Host- prefix #2269
Cookie Helper - Check bis condition #2314
jsx/dom - Add more React staff #2197
SSG - Generate files concurrently #2187
HTTP Exception - Add cause option #2224
Logger - Support NO_COLOR #2228

All Updates

feat: Add a "cause" option to HTTPException by @Karibash in #2224
feat(logger): support NO_COLOR by @ryuapp in #2228
feat(cookie): add secure and host prefix support by @Datron in #2269
feat(ssg): generate files concurrently by @usualoma in #2187
feat(jsx): more react staff by @usualoma in #2197
feat: introduce Body Limit Middleware using stream by @yusukebe in #2309
feat: Introduce WebSocket Helper / Adapter by @nakasyou in #2265
refactor(SSG): separate middleware logic by @watany-dev in #2315
chore: bump up @hono/node-server by @yusukebe in #2323
fix(body-limit): export bodyLimit for Deno by @yusukebe in #2324
fix(websocket): export WebSocket helper for Deno by @yusukebe in #2325
feat(cookie): Add Cookie bis condition check by @Jxck in #2314
Next by @yusukebe in #2327

New Contributors

@Karibash made their first contribution in #2224
@Datron made their first contribution in #2269
@Jxck made their first contribution in #2314

Full Changelog: v4.0.10...v4.1.0

hono 4.1.0 v4.1.0 on Node.js NPM