tRPC 伺服器文件 | tRPC 繁體中文

📄️ 定義路由器

若要開始建置基於 tRPC 的 API，您首先需要定義路由器。一旦您掌握了基礎知識，就可以自訂路由器以符合更進階的使用案例。

程序是公開給用戶端的功能，它可以是下列其中之一

tRPC 程序可以為其輸入和/或輸出定義驗證邏輯，驗證器也用於推斷輸入和輸出的類型。我們對許多熱門驗證器提供一流的支援，而且您可以整合我們不直接支援的驗證器。

在同一個檔案中撰寫所有 API 程式碼並非明智之舉。很容易將路由器與其他路由器合併。

您的背景包含所有 tRPC 程序可存取的資料，也是放置資料庫連線或驗證資訊等內容的理想位置。

您可以使用 t.procedure.use() 方法將中介軟體新增至程序。中介軟體會包裝程序呼叫，且必須傳遞其回傳值。

6 項

您可能需要直接從主機其程序的伺服器呼叫您的程序，可以使用 createCallerFactory() 來達成此目的。這對於伺服器端呼叫和 tRPC 程序的整合測試很有用。

createContext 函式會針對每個傳入的請求呼叫，因此您可以在這裡從請求物件新增呼叫使用者的背景資訊。

每當程序中發生錯誤時，tRPC 會回應客戶端一個包含「錯誤」屬性的物件。此屬性包含您在客戶端處理錯誤所需的所有資訊。

路由器中的錯誤格式化會推論到您的客戶端（& React 元件）

您可以序列化回應資料和輸入參數。轉換器需要同時新增至伺服器和客戶端。

程序元資料讓您可以新增一個程序特定元屬性，此屬性會出現在所有中介軟體函式參數中。

以下範例使用 Vercel 的邊緣快取，以最快的速度為您的使用者提供資料。