Middleware Context Storage

Le middleware Context Storage stocke le Context de Hono dans AsyncLocalStorage afin de le rendre accessible globalement.

Information

Remarque : Ce middleware utilise AsyncLocalStorage. L’environnement d’exécution doit le prendre en charge.

Cloudflare Workers : Pour activer AsyncLocalStorage, ajoutez le drapeau nodejs_compat ou nodejs_als à votre fichier wrangler.toml.

Importation

import { Hono } from 'hono'
import {
  contextStorage,
  getContext,
  tryGetContext,
} from 'hono/context-storage'

Utilisation

getContext() renvoie l’objet Context actuel si contextStorage() est appliqué comme middleware.

type Env = {
  Variables: {
    message: string
  }
}

const app = new Hono<Env>()

app.use(contextStorage())

app.use(async (c, next) => {
  c.set('message', 'Hello!')
  await next()
})

// You can access the variable outside the handler.
const getMessage = () => {
  return getContext<Env>().var.message
}

app.get('/', (c) => {
  return c.text(getMessage())
})

Sur Cloudflare Workers, vous pouvez accéder aux liaisons en dehors du gestionnaire.

type Env = {
  Bindings: {
    KV: KVNamespace
  }
}

const app = new Hono<Env>()

app.use(contextStorage())

const setKV = (value: string) => {
  return getContext<Env>().env.KV.put('key', value)
}

tryGetContext

tryGetContext() fonctionne comme getContext(), mais renvoie undefined au lieu de lever une erreur lorsque le contexte n’est pas disponible :

const context = tryGetContext<Env>()
if (context) {
  // Context is available
  console.log(context.var.message)
}