Débuter avec HonoJS pour des API Web Légères

Créer des API web modernes ne devrait pas nécessiter des frameworks lourds ou des configurations complexes. Si vous recherchez une alternative rapide et légère à Express ou Koa qui fonctionne sur plusieurs environnements d’exécution JavaScript, HonoJS pourrait être exactement ce dont vous avez besoin.

Ce qui Rend HonoJS Différent

HonoJS est un framework web petit et ultra-rapide construit sur les Standards Web. Contrairement aux frameworks Node.js traditionnels, il fonctionne sur n’importe quel environnement d’exécution JavaScript—Node.js, Bun, Deno, Cloudflare Workers, AWS Lambda, et plus encore. Cette portabilité provient de sa fondation sur les API Web standards comme Request, Response et Fetch.

import { Hono } from 'hono'
const app = new Hono()

app.get('/', (c) => c.text('Hello Hono!'))

export default app

Voici une application HonoJS complète. Pas de code passe-partout, pas de configuration complexe—juste du JavaScript moderne et propre.

Configuration de Votre Première API HonoJS

Construisons une API REST simple pour voir HonoJS en action. D’abord, créez un nouveau projet :

npm create hono@latest my-api

Choisissez votre environnement d’exécution préféré (Node.js, Bun, ou Cloudflare Workers). Pour cet exemple, nous utiliserons Node.js :

cd my-api
npm install
npm run dev

Votre serveur fonctionne maintenant sur http://localhost:3000.

Construction de Routes REST avec HonoJS

HonoJS utilise une syntaxe de routage familière qui semble naturelle si vous avez utilisé Express :

import { Hono } from 'hono'
const app = new Hono()

// Endpoint GET
app.get('/api/users', (c) => {
  const users = [
    { id: 1, name: 'Alice' },
    { id: 2, name: 'Bob' }
  ]
  return c.json(users)
})

// Endpoint POST avec analyse JSON
app.post('/api/users', async (c) => {
  const body = await c.req.json()
  // En production, sauvegarder en base de données
  return c.json({ message: 'User created', data: body }, 201)
})

// Routes dynamiques
app.get('/api/users/:id', (c) => {
  const id = c.req.param('id')
  return c.json({ id, name: 'User ' + id })
})

export default app

L’objet Context (c) fournit tout ce dont vous avez besoin : données de requête, assistants de réponse, et utilitaires pour les en-têtes, cookies, et plus encore.

Middleware pour des API Prêtes pour la Production

HonoJS inclut des middlewares essentiels prêts à l’emploi. Voici comment ajouter CORS, la journalisation et la compression :

import { Hono } from 'hono'
import { cors } from 'hono/cors'
import { logger } from 'hono/logger'
import { compress } from 'hono/compress'

const app = new Hono()

// Appliquer les middlewares
app.use('*', logger())
app.use('*', cors())
app.use('*', compress())

// Vos routes ici
app.get('/api/health', (c) => c.json({ status: 'ok' }))

export default app

Créer un middleware personnalisé est simple :

// Middleware d'authentification simple
const authMiddleware = async (c, next) => {
  const token = c.req.header('Authorization')
  if (!token || token !== 'Bearer secret-token') {
    return c.json({ error: 'Unauthorized' }, 401)
  }
  await next()
}

// Appliquer à des routes spécifiques
app.use('/api/protected/*', authMiddleware)
app.get('/api/protected/data', (c) => {
  return c.json({ secret: 'This is protected data' })
})

Portabilité d’Environnement : Déployez Partout

L’un des plus grands avantages de HonoJS est sa flexibilité d’environnement d’exécution. Le même code fonctionne sur différentes plateformes avec des changements minimaux :

Pour Cloudflare Workers :

export default app

Pour Node.js :

import { serve } from '@hono/node-server'
serve({ fetch: app.fetch, port: 3000 })

Pour Bun :

export default { port: 3000, fetch: app.fetch }

Cela signifie que vous pouvez commencer le développement localement et déployer sur des emplacements edge sans réécrire votre API.

Extension avec Intégration de Base de Données

Voici un exemple rapide utilisant Drizzle ORM avec HonoJS :

import { Hono } from 'hono'
import { drizzle } from 'drizzle-orm/better-sqlite3'
import Database from 'better-sqlite3'
import { postsTable } from './schema'

const sqlite = new Database('app.db')
const db = drizzle(sqlite)

const app = new Hono()

app.get('/api/posts', async (c) => {
  const posts = await db.select().from(postsTable)
  return c.json(posts)
})

app.post('/api/posts', async (c) => {
  const { title, content } = await c.req.json()
  const result = await db.insert(postsTable).values({ title, content })
  return c.json(result, 201)
})

export default app

Avantages en Termes de Performance

Les API HonoJS surpassent constamment Express dans les benchmarks. Sa surcharge minimale et sa fondation sur les Standards Web signifient des temps de réponse plus rapides et une utilisation mémoire plus faible. Pour les déploiements edge, la petite taille de bundle (moins de 20KB) se traduit par des démarrages à froid plus rapides.

Conclusion

HonoJS offre une approche rafraîchissante pour construire des API web. Sa combinaison de simplicité, performance et flexibilité d’environnement d’exécution en fait un excellent choix pour les applications JavaScript modernes. Que vous construisiez des microservices, des fonctions serverless ou des API REST traditionnelles, HonoJS fournit les outils dont vous avez besoin sans le superflu.

Commencez avec une API simple, ajoutez des middlewares selon vos besoins, et déployez partout—c’est la méthode HonoJS.

FAQ

Gain Debugging Superpowers

Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers. Check our GitHub repo and join the thousands of developers in our community.