アダプター
tRPCはそれ自体ではサーバーではなく、単純なNode.js HTTPサーバー、Express、またはNext.jsなどの他のホストを使用して提供する必要があります。ほとんどのtRPC機能は、どのバックエンドを選択しても同じです。アダプターは、ホストシステムとtRPC API間の接着剤として機能します。
アダプターは通常、createContext
を介したコンテキスト作成の設定や、onError
を介したエラーのグローバル処理を可能にする一般的な規則に従いますが、重要なのは、アプリケーションに適したホストを選択できることです。
APIをホストする多くのモードをサポートしており、こちらに記載されています。
- サーバー側のAPIの場合、スタンドアロンアダプターを使用するか、ExpressまたはFastifyアダプターを使用して既存のAPIに接続できます。
- サーバーレスソリューションが必要な場合は、AWS Lambdaを選択するか、エッジランタイムの場合はFetchを選択できます。
- フルスタックフレームワークを使用しており、Next.jsのような完全な統合が必要な場合は、Next.js、Astro、Remix、またはSolidStartでFetchアダプターを使用できます。
ヒント
ローカル開発またはサーバー側のインフラストラクチャの場合、使用する最も簡単なアダプターはスタンドアロンアダプターです。これは、標準のNode.js HTTPサーバーを実行するために使用できます。迅速に開始する必要があり、統合する既存のHTTPサーバーがない場合は、これをお勧めします。後でニーズが変わった場合に、後から交換するのは簡単です。