tRPC 服务器文档 | tRPC 中文

📄️ 定义路由

要开始构建基于 tRPC 的 API，您首先需要定义您的路由器。掌握基本知识后，您可以为更高级的用例自定义路由器。

过程是暴露给客户端的函数，它可以是

tRPC 过程可以为其输入和/或输出定义验证逻辑，验证器也用于推断输入和输出的类型。我们对许多流行的验证器提供一流的支持，您可以集成我们不支持的验证器。

在您的代码中将所有 API 代码写入同一个文件不是一个好主意。使用其他路由器合并路由器很容易。

您的上下文保存所有 tRPC 过程都可以访问的数据，是放置数据库连接或身份验证信息等内容的好地方。

您可以使用 t.procedure.use() 方法将中间件添加到过程。中间件将包装过程的调用，并且必须通过其返回值。

6 个项目

您可能需要直接从托管它们的同一服务器调用您的过程，可以使用 createCallerFactory() 来实现。这对于服务器端调用和 tRPC 过程的集成测试很有用。

createContext 函数在每个传入请求时调用，因此您可以在此处添加有关来自请求对象的调用用户的上下文信息。

每当过程发生错误时，tRPC 都会向客户端响应一个包含“error”属性的对象。此属性包含您在客户端处理错误所需的所有信息。

路由器中的错误格式化将一直推断到您的客户端（& React 组件）

您可以序列化响应数据和输入参数。转换器需要添加到服务器和客户端。

过程元数据允许您添加一个可选的过程特定元属性，该属性将在所有中间件函数参数中可用。

以下示例使用 Vercel 的边缘缓存，以尽可能快地为您的用户提供数据。