Adapter Helper

Adapter Helper 提供了一种通过统一接口与各种平台无缝交互的方式。

Import

import { Hono } from 'hono'
import { env, getRuntimeKey } from 'hono/adapter'

env()

env() 函数有助于在不同运行时环境中检索环境变量，而不仅仅局限于 Cloudflare Workers 的 Bindings。 使用 env(c) 可以检索到的值可能因不同的运行时环境而异。

import { env } from 'hono/adapter'

app.get('/env', (c) => {
  // NAME 在 Node.js 或 Bun 上是 process.env.NAME
  // NAME 是在 Cloudflare 上 `wrangler.toml` 中写入的值
  const { NAME } = env<{ NAME: string }>(c)
  return c.text(NAME)
})

支持的运行时、Serverless 平台和云服务：

• Cloudflare Workers
  • wrangler.toml
• Deno
  • Deno.env
  • .env 文件
• Bun
  • Bun.env
  • process.env
• Node.js
  • process.env
• Vercel
  • Vercel 上的环境变量
• AWS Lambda
  • AWS Lambda 上的环境变量
• Lambda@Edge
  在 Lambda@Edge 上，Lambda 的环境变量不被支持，你需要使用 Lamdba@Edge 事件 作为替代方案。
• Fastly Compute
  在 Fastly Compute 上，你可以使用 ConfigStore 来管理用户自定义数据。
• Netlify
  在 Netlify 上，你可以使用 Netlify Contexts 来管理用户自定义数据。

指定运行时

你可以通过传递运行时键作为第二个参数来指定运行时环境，以获取环境变量。

app.get('/env', (c) => {
  const { NAME } = env<{ NAME: string }>(c, 'workerd')
  return c.text(NAME)
})

getRuntimeKey()

getRuntimeKey() 函数返回当前运行时的标识符。

app.get('/', (c) => {
  if (getRuntimeKey() === 'workerd') {
    return c.text('You are on Cloudflare')
  } else if (getRuntimeKey() === 'bun') {
    return c.text('You are on Bun')
  }
  ...
})

可用的运行时键

以下是可用的运行时键，不可用的运行时键可能会被支持并标记为 other，其中一些灵感来源于 WinterCG 的运行时键：

• workerd - Cloudflare Workers
• deno
• bun
• node
• edge-light - Vercel Edge Functions
• fastly - Fastly Compute
• other - 其他未知的运行时键