React Doctor은(는) 무엇을 하나요?
React 코드베이스를 스캔하여 보안, 성능, 정확성 및 아키텍처 문제를 진단합니다. 0~100점 사이의 점수와 실행 가능한 진단 결과를 제공합니다.
사용법
npx -y react-doctor@latest . --verbose
워크플로우
- 프로젝트 루트에서 위 명령어를 실행합니다.
- 파일 경로와 라인 번호가 포함된 모든 진단 내용을 읽습니다.
- 오류(가장 높은 심각도)부터 시작하여 문제를 수정합니다.
- 점수가 개선되었는지 확인하기 위해 다시 실행합니다.
규칙 (47개 이상)
- 보안: 클라이언트 번들 내 하드코딩된 비밀, eval()
- 상태 및 효과: useEffect 내 파생 상태, 누락된 정리(cleanup), props에서 파생된 useState, 연쇄 setState
- 아키텍처: 컴포넌트 내부의 컴포넌트, 거대한 컴포넌트, 인라인 렌더 함수
- 성능: 레이아웃 속성 애니메이션, transition-all, 큰 blur 값
- 정확성: 배열 인덱스를 key로 사용, 조건부 렌더링 버그
- Next.js: 누락된 메타데이터, 서버 데이터에 대한 클라이언트 측 fetching, 비동기 클라이언트 컴포넌트
- 번들 크기: 배럴(barrel) 임포트, 전체 lodash, moment.js, 누락된 코드 분할
- 서버: 서버 액션에서 누락된 인증, after() 없이 차단
- 접근성: prefers-reduced-motion 누락
- 데드 코드: 사용되지 않는 파일, 익스포트, 타입
점수
- 75+: 우수
- 50-74: 개선 필요
- 0-49: 심각