ConnInfo

ConnInfo可以帮助你获取连接信息。例如，你可以轻松获取客户端的远程地址。

导入

Cloudflare Workers

import { Hono } from 'hono'
import { getConnInfo } from 'hono/cloudflare-workers'

Deno

import { Hono } from 'hono'
import { getConnInfo } from 'hono/deno'

Bun

import { Hono } from 'hono'
import { getConnInfo } from 'hono/bun'

Vercel

import { Hono } from 'hono'
import { getConnInfo } from 'hono/vercel'

Lambda@Edge

import { Hono } from 'hono'
import { getConnInfo } from 'hono/lambda-edge'

Node.js

import { Hono } from 'hono'
import { getConnInfo } from '@hono/node-server/conninfo'

使用方法

const app = new Hono()

app.get('/', (c) => {
  const info = getConnInfo(c) // info 的类型为 `ConnInfo`
  return c.text(`你的远程地址是 ${info.remote.address}`)
})

类型定义

通过 getConnInfo() 可以获取的值的类型定义如下：

type AddressType = 'IPv6' | 'IPv4' | undefined

type NetAddrInfo = {
  /**
   * 传输协议类型
   */
  transport?: 'tcp' | 'udp'
  /**
   * 传输端口号
   */
  port?: number

  address?: string
  addressType?: AddressType
} & (
  | {
      /**
       * 主机名，如 IP 地址
       */
      address: string

      /**
       * 主机名类型
       */
      addressType: AddressType
    }
  | {}
)

/**
 * HTTP 连接信息
 */
interface ConnInfo {
  /**
   * 远程信息
   */
  remote: NetAddrInfo
}