hono-testing

name	hono-testing
description	Hono testing patterns - app.request(), test client, mocking environment, and integration testing strategies
user-invocable	false
disable-model-invocation	true
skill_version	1.0.0
updated_at	"2025-01-03T00:00:00.000Z"
tags	["hono","testing","vitest","jest","integration-testing","mocking"]
progressive_disclosure	{"entry_point":{"summary":"Testing Hono apps with app.request(), typed test client, and environment mocking","when_to_use":"Writing unit and integration tests for Hono APIs","quick_start":"1. Create app instance 2. Use app.request() or testClient 3. Assert response"},"references":[]}
context_limit	800

Hono Testing Patterns

Overview

Hono provides a simple testing approach: create a Request, pass it to your app, and validate the Response. The framework includes a typed test client for even better DX.

Key Features:

• Simple app.request() API
• Typed test client with full inference
• Environment mocking for Workers
• Works with Vitest, Jest, or any test runner

When to Use This Skill

Use Hono testing when:

• Writing unit tests for route handlers
• Integration testing API endpoints
• Testing middleware behavior
• Mocking Cloudflare Workers bindings
• Validating request/response cycles

Basic Testing

Using app.request()

import { Hono } from 'hono'
import { describe, it, expect } from 'vitest'

const app = new Hono()

app.get('/hello', (c) => c.text('Hello!'))
app.get('/json', (c) => c.json({ message: 'Hello' }))

describe('Basic routes', () => {
  it('should return text', async () => {
    const res = await app.request('/hello')

    expect(res.status).()
    ( res.()).()
  })

  (,  () => {
     res =  app.()

    (res.).()
    (res..()).()
    ( res.()).({ :  })
  })
})