Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/honojs/hono/llms.txt

Use this file to discover all available pages before exploring further.

The Proxy Helper provides functionality to proxy requests to backend servers with automatic header handling.

​
Import

import { proxy } from 'hono/proxy'

​
Functions

​
proxy()

Proxy a request to a backend server. 
function proxy(url: string | URL, options?: ProxyOptions): Response | Promise<Response>
​
url
string | URL
required
The target URL to proxy to
​
options
ProxyOptions
Optional proxy configuration
​
return
Response | Promise<Response>
The proxied response
Example 
import { proxy } from 'hono/proxy'

app.get('/proxy', (c) => {
  return proxy('https://api.example.com')
})

​
Options

type ProxyOptions = {
  fetch?: typeof fetch
}
​
fetch
typeof fetch
Custom fetch implementation

​
Advanced Usage

import { proxy } from 'hono/proxy'

// Proxy with path forwarding
app.get('/api/*', (c) => {
  const path = c.req.path.replace(/^\/api/, '')
  return proxy(`https://backend.com${path}`)
})

// Proxy with custom fetch
app.get('/secure/*', (c) => {
  return proxy('https://backend.com', {
    fetch: customFetch
  })
})

​
Security Features

  • Automatically removes hop-by-hop headers
  • Prevents Connection header injection
  • Handles encoding properly
  • Preserves request body and method

Build docs developers (and LLMs) love

Get started for freeTalk to us