custom hook api

커스텀 훅의 역할 범위 정하기

커스텀 훅은 반복 로직을 감추는 도구이지만, 반환 API와 내부 effect 책임이 흐려지면 호출부가 더 어려워집니다.

Input

입력 계약

hook 인자는 초기값, 옵션, 외부 id처럼 재사용 기준이 되는 값만 받습니다.

State

내부 상태

loading, error, data처럼 함께 움직이는 상태를 hook 내부에서 일관되게 관리합니다.

Return

반환 API

호출부가 UI 결정을 할 수 있도록 값과 명령을 명확히 나눠 반환합니다.

deps

hook 내부 effect 의존성이 인자와 맞는지 확인합니다.

name

use로 시작하고 호출 규칙을 깨지 않는 위치에서만 씁니다.

test

동일 입력에서 같은 상태 전이가 나오는지 작은 예제로 검산합니다.