React: 폼 제어 비제어 전환 동작을 검증하는 법

검증 범위

폼 제어 비제어 전환에서 유지해야 할 동작과 바뀌어야 할 결과를 나눠 적습니다. input value가 undefined에서 문자열로 바뀌면 uncontrolled에서 controlled로 전환되므로 초기값과 source of truth를 일관되게 유지해야 합니다.

대표·경계·실패 조건

render에서 계산할 값, 사용자가 소유한 state와 외부 시스템 동기화를 구분합니다. update를 시작한 값과 다시 update된 dependency를 따라가면 순환 원인을 찾을 수 있습니다.

조건	확인할 내용
대표 사례	자주 쓰는 조건에서 기대 결과가 나오는가
경계	값이나 동작이 바뀌는 지점이 안전한가
실패	오류가 정해진 방식으로 드러나고 중간 상태가 남지 않는가
반복	다시 실행해도 결과가 예측 가능한가

완료 판단

수정 전 실패 사례는 사라지고 기존 정상 사례는 유지돼야 합니다. Strict Mode, 느린 네트워크, 빠른 입력과 unmount 조건에서 렌더 비용과 cleanup을 검증한다. 초기 render, 연속 입력, 느린 응답의 순서 역전, unmount와 SSR hydration에서 state·DOM·cleanup이 기대한 순서로 바뀌는지 확인합니다. 한 번의 가장 좋은 결과나 화면 한 장으로 완료를 선언하지 않습니다. 실패 입력과 기대 결과를 자동 test나 실행 가능한 점검으로 남깁니다.

공식 문서와 적용 범위

• React Documentation (새 창에서 열림)

문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.