#9PredictabilityEasy

API Client — Names Shadow Browser APIs

API Client — 이름이 표준 API 와 충돌

API 헬퍼들이 fetch, get, post, remove 같은 너무 일반적인 이름을 가지고 있습니다. 그런데 동작은 표준 fetch/HTTP 메서드와 다름 — auto JSON, auto retry, auto auth header, 자동 캐싱 등. 사용하는 사람이 이름만 보고 표준 동작을 기대하면 예상 밖의 결과 가 나옴.

할 일

각 함수의 이름을 자기 동작을 드러내는 이름으로 바꾸세요:

  • fetch (자동 JSON 파싱 + 에러 throw + 캐싱) → fetchJSON
  • get (자동 토큰 + retry + cache-bust 타임스탬프) → getWithAuth
  • post (자동 CSRF + 토큰 refresh) → postWithCSRF
  • remove (실제론 soft delete) → softDelete

동작은 유지 — 이름만 정확하게.

학습 포인트

  • 표준 API 이름을 덮어쓰지 말 것 (mental model 깨짐)
  • 이름은 동작의 요약. 자동으로 일어나는 일은 이름에 담아라
Sandpack 로드 중…