下一个适配器
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS · Linux · Windows
- 运行环境要求
- Node.js
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Next.js Adapter
[Next.js](https://nextjs.org/) integration. Works with App Router and Pages Router.
> oRPC also supports [Server Action](/docs/server-action) out of the box.
## Server
```ts
// app/rpc/[[...rest]]/route.ts
import { RPCHandler } from '@orpc/server/fetch'
import { onError } from '@orpc/server'
const handler = new RPCHandler(router, {
interceptors: [onError(e => console.error(e))],
})
async function handleRequest(request: Request) {
const { response } = await handler.handle(request, {
prefix: '/rpc',
context: {},
})
return response ?? new Response('Not found', { status: 404 })
}
export const HEAD = handleRequest
export const GET = handleRequest
export const POST = handleRequest
export const PUT = handleRequest
export const PATCH = handleRequest
export const DELETE = handleRequest
```
## Pages Router Support
```ts
// pages/api/rpc/[[...rest]].ts
import { RPCHandler } from '@orpc/server/node'
const handler = new RPCHandler(router)
export const config = {
api: { bodyParser: false },
}
export default async (req, res) => {
const { matched } = await handler.handle(req, res, {
prefix: '/api/rpc',
context: {},
})
if (matched) return
res.statusCode = 404
res.end('Not found')
}
```
> Disable the body parser to fully utilize oRPC features like [Bracket Notation](/docs/openapi/bracket-notation).
## Client
```ts
// lib/orpc.ts
import { RPCLink } from '@orpc/client/fetch'
const link = new RPCLink({
url: `${typeof window !== 'undefined' ? window.location.origin : 'http://localhost:3000'}/rpc`,
headers: async () => {
if (typeof window !== 'undefined') return {}
const { headers } = await import('next/headers')
return await headers()
},
})
```
## Optimize SSR
```ts
// lib/orpc.ts
import type { RouterClient } from '@orpc/server'
import { RPCLink } from '@orpc/client/fetch'
import { createORPCClient } from '@orpc/client'
declare global {
var $client: RouterClient<typeof router> | undefined
}
const link = new RPCLink({
url: () => {
if (typeof window === 'undefined') {
throw new Error('RPCLink is not allowed on server')
}
return `${window.location.origin}/rpc`
},
})
export const client: RouterClient<typeof router> = globalThis.$client ?? createORPCClient(link)
```
```ts
// lib/orpc.server.ts
import 'server-only'
import { headers } from 'next/headers'
import { createRouterClient } from '@orpc/server'
globalThis.$client = createRouterClient(router, {
context: async () => ({ headers: await headers() }),
})
```
```ts
// instrumentation.ts
export async function register() {
await import('./lib/orpc.server')
}
```
---
> Source: [ali-master/skills](https://github.com/ali-master/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
页面路由器支持
优化SSR
文件/命令 -> ${typeof window !== 'undefined' ? window.location.origin : 'http://localhost:3000'}/rpc · ${window.location.origin}/rpc · Next.js · docs/server-action · app/rpc · route.ts · orpc/server/fetch · orpc/server
内容校验值 -> 9292a3b7f0d0
当前原文的自动摘译,尚未人工审校。
页面路由器支持
禁用主体解析器以充分利用 oRPC 功能,例如括号表示法。
优化SSR
来源:ali-master/skills — 由 TomeVault 分发。