본문 바로가기
버전: 11.x
비공식 베타 번역

이 페이지는 PageTurner AI로 번역되었습니다(베타). 프로젝트 공식 승인을 받지 않았습니다. 오류를 발견하셨나요? 문제 신고 →

tRPC 클라이언트

"Vanilla" tRPC 클라이언트를 사용하면 API 프로시저를 마치 로컬 함수처럼 호출할 수 있어 원활한 개발 경험을 제공합니다.

ts
import type { AppRouter } from '../path/to/server/trpc';
const bilbo = await client.getUser.query('id_bilbo');
// => { id: 'id_bilbo', name: 'Bilbo' };
ts
import type { AppRouter } from '../path/to/server/trpc';
const bilbo = await client.getUser.query('id_bilbo');
// => { id: 'id_bilbo', name: 'Bilbo' };

Vanilla 클라이언트를 언제 사용해야 하나요?​

주로 다음과 같은 두 가지 시나리오에서 이 클라이언트를 사용하게 됩니다:

  • 공식 통합이 제공되지 않는 프론트엔드 프레임워크와 함께 사용할 때

  • TypeScript로 작성된 별도의 백엔드 서비스와 함께 사용할 때

Vanilla 클라이언트를 사용하지 말아야 할 경우는?​

  • React 컴포넌트에서 프로시저를 호출할 때 이 클라이언트를 사용할 수 있지만, 일반적으로는 React Query 통합을 사용하는 것이 좋습니다. React Query 통합은 로딩 및 오류 상태 관리, 캐싱, 무효화와 같은 많은 추가 기능을 제공합니다.

  • 동일한 API 인스턴스 내에서 프로시저를 호출할 때는 이 클라이언트를 사용하지 않는 것을 권장합니다. 이는 호출이 네트워크 계층을 통과해야 하기 때문입니다. 현재 API에서 프로시저를 호출하는 방법에 대한 자세한 권장 사항은 여기에서 자세히 알아보세요.