최근 Blogger 관리자 UI 자동화 스크립트를 작성하다가 꽤나 당황스러운 문제를 겪었다. 인풋 엘리먼트에 자바스크립트로 값을 넣었는데, 화면에는 잘 보이다가도 저장 버튼만 누르면 내부 상태 값이 비어있어 제대로 반영되지 않는 현상이었다.
단순히 엘리먼트의 속성을 변경하는 방식으로는 해결되지 않아서 한참 원인을 분석하고 디버깅을 진행했다. 나와 같은 문제를 겪고 있을 분들을 위해 원인과 확실한 해결법을 정리해 보려 한다.
1. 스크립트로 값을 넣었는데 상태가 안 바뀌는 원인
DOM 자동화를 진행할 때 웹 페이지의 인풋 요소에 el.value = x 방식으로 값을 할당하는 것은 가장 흔하고 직관적인 방법이다. 나 역시 관리자 화면의 반복적인 입력 폼을 코드로 처리하기 위해 이 방식을 먼저 시도했다.
하지만 리액트 기반으로 작성된 폼에서는 화면 렌더링만 값이 들어간 것처럼 보일 뿐, 실제 리액트 내부 상태(React state)는 전혀 업데이트되지 않았다. 이 문제는 리액트가 인풋 요소의 기본 value setter를 자체적으로 오버라이드하여 상태 변경을 감지하기 때문에 발생한다.
즉, 자바스크립트로 value 속성을 직접 수정하면 리액트가 이 변경 사항을 인지하지 못해 리액트 컨트롤드 인풋 자동입력 안됨 현상이 일어나는 것이다.
2. 네이티브 setter를 가져와 직접 실행하기
단순한 속성 값 할당으로 해결되지 않는다면, 리액트에 의해 재정의되기 전의 원래 HTML 프로토타입 메서드를 직접 호출해 줄 필요가 있다. 여기서 핵심적인 역할을 하는 개념이 바로 네이티브 setter다.
HTMLInputElement의 프로토타입에서 원래의 value 프로퍼티 디스크립터를 추출하여 원본 setter 함수를 확보하는 방식을 사용했다. Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set 구문을 활용하면 리액트의 감시망을 우회하여 순수한 DOM 인풋에 값을 제대로 심을 수 있게 된다.
이렇게 가져온 네이티브 setter에 대상 인풋 엘리먼트와 설정하고 싶은 값을 바인딩하여 실행해 주면, 1차적으로 인풋 요소 내부의 데이터가 안전하게 변경된다.
3. input change 이벤트 dispatch로 상태 동기화 완결
네이티브 setter를 통해 값을 성공적으로 주입했다고 해서 작업이 완전히 끝난 것은 아니다. 리액트는 인풋에서 발생하는 이벤트를 수신하여 내부 컴포넌트 상태를 동기화하므로, 값이 바뀌었다는 신호를 수동으로 만들어 보내야 한다.
이 단계에서 반드시 필요한 작업이 바로 input change 이벤트 dispatch 과정이다. 값을 주입한 직후 브라우저의 Event 객체를 사용해 'input' 이벤트와 'change' 이벤트를 연속으로 생성하고 이를 해당 인풋 요소에 디스패치해 주었다.
이렇게 이벤트를 수동으로 발송하자 리액트의 이벤트 리스너가 변경을 감지하였고, 비로소 리액트 내부 상태까지 완벽하게 동기화되는 것을 확인할 수 있었다.
4. 수동 입력의 굴레에서 벗어난 실제 적용 결과
이 원리와 트릭을 적용한 덕분에 진행 중이던 관리자 UI 자동화 작업을 무사히 마칠 수 있었다. 기존에 손으로 일일이 클릭하며 채워 넣어야 했던 35건과 18건 규모의 반복적인 폼 입력 작업을 코드로 오차 없이 안전하게 처리해 냈다.
처음에는 왜 화면에 보이는 값이 저장되지 않는지 막막했지만, DOM의 표준 동작 방식과 리액트의 이벤트 감지 구조를 깊이 이해할 수 있었던 좋은 계기였다.
나처럼 브라우저 DOM 자동화 스크립트를 작성하다가 리액트 상태 동기화 문제로 삽질하고 계신 분들이라면, 네이티브 setter 사용과 이벤트 디스패치 조합을 꼭 시도해 보시길 권한다.