Skip to main content
← Glossary

React 클라이언트 경계

React Client boundary

use client 파일을 브라우저 실행 코드의 진입점으로 삼고, 그 파일이 가져오는 모듈까지 클라이언트 쪽으로 분류하는 경계다.

같은 뜻으로 쓰는 말

  • 클라이언트 경계
  • Client boundary

마지막 검증

React 클라이언트 경계는 파일 맨 위의 'use client'로 시작한다. 이 파일에서 내보낸 컴포넌트를 서버 컴포넌트가 직접 사용하면 서버에서 클라이언트로 넘어가는 진입점이 된다. 해당 파일과 import로 이어지는 의존 모듈은 브라우저에서 실행할 클라이언트 모듈 그래프에 포함된다.

모든 클라이언트 컴포넌트 파일에 지시문을 반복할 필요는 없다. 상태, 사건 처리, Effect나 브라우저 API가 처음 필요한 진입 파일에 경계를 두고, 그 아래에서 import되는 파일은 같은 클라이언트 영역으로 분류한다. 서버 컴포넌트가 미리 렌더해 children 같은 prop으로 전달한 결과는 시각적으로 경계 안에 보여도 클라이언트 컴포넌트가 import한 모듈이 아니다.

출처와 검증 범위

아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.

  1. use clientReact · 공식 문서 · 확인 2026-08-09
  2. use clientNext.js · 공식 문서 · 확인 2026-08-09