jQuery 4.1의 커스텀 폼 요소, 제출값은 어디서 읽을까
jQuery 4.1은 폼에 연결된 커스텀 요소를 직렬화 대상에 포함한다. 폼 전체와 개별 요소의 수집 차이, 브라우저 제출값과 .val()의 경계를 살펴 기존 폼에 점진적으로 적용할 조건을 정리한다.
날짜 입력을 커스텀 요소로 바꿨는데 화면에는 값이 보이고 서버에는 빈값이 도착한다면, 먼저 제출 코드를 살펴야 한다. 브라우저가 아는 입력값과 jQuery가 읽는 값은 같은 경로로 전달되지 않을 수 있다. jQuery 4.1의 폼 연결 커스텀 요소 지원은 기존 폼을 조금씩 바꿀 때 유용하지만, 이 두 경로를 자동으로 같게 만들지는 않는다.
jQuery 팀은 11월 17일 공식 발표에서 4.1.0과 3.8.0을 함께 공개했다. GeekNews 등록은 18일 오전 7시 40분, 한국 시각이다. 아래는 발표와 4.1.0 소스, 웹 표준을 대조한 분석이다. jQuery를 설치하거나 폼 제출을 직접 실행해 확인한 결과는 아니다.
바뀐 것은 폼에서 요소를 모으는 기준이다
커스텀 요소는 개발자가 이름과 동작을 정의해 등록하는 HTML 요소다. 그중 클래스에 static formAssociated = true를 선언한 요소는 브라우저의 폼에 참여할 수 있다. 컴포넌트는 ElementInternals라는 내부 연결 객체의 setFormValue()로 제출값을 전달한다. 화면 안에 입력 상자처럼 생긴 요소가 있다는 사실만으로 이 연결이 생기지는 않는다. 폼 연결 요소의 정의
이전 직렬화 구현은 폼의 elements 목록을 얻은 뒤에도 태그 이름이 기존 입력 요소에 해당하는지 검사했다. 커스텀 요소가 브라우저의 폼 목록에 들어 있어도 이 검사에서 빠질 수 있었다. 4.1은 폼에서 얻은 목록에는 태그 이름 검사를 적용하지 않도록 바꿨다. 변경 내용과 공식 테스트
여기서 호출 대상이 중요하다. 폼 전체에 .serializeArray()를 호출하면 새 경로를 사용하지만, 커스텀 요소만 따로 골라 호출하면 여전히 태그 이름 검사를 거친다. 기존 코드가 폼 대신 :input 같은 선택자로 입력들을 모으고 있었다면, 라이브러리 버전만 올려서는 새 컴포넌트가 포함되지 않을 수 있다. 내가 먼저 찾을 것은 직렬화 메서드의 이름보다 그 앞에서 무엇을 선택했는가다. 4.1.0 직렬화 구현
제출값을 등록하는 일과 값을 읽게 하는 일
요소를 목록에 넣은 다음에도 확인할 계약이 남는다. 4.1.0의 직렬화 코드는 요소의 name을 확인하고, 값은 jQuery(this).val()로 읽는다. 별도 값 읽기 훅이 없다면 .val()은 요소의 value 프로퍼티를 읽는다. setFormValue()에 저장한 내부 제출값을 가져오는 구현이 아니다. 직렬화 소스, 값 읽기 소스
공식 변경에 추가된 테스트도 커스텀 요소에 name과 value getter를 직접 정의한다. getter는 프로퍼티를 읽을 때 값을 반환하는 접근자다. 따라서 HTML에 name 속성을 붙이고 내부 제출값을 설정했다는 사실만으로 기존 jQuery 코드가 필요한 이름과 값을 모두 얻는다고 가정하면 안 된다. 공식 테스트의 요소 정의
가령 화면에는 지역화된 날짜를 표시하고 서버에는 정규화된 날짜 문자열을 보낸다고 하자. 브라우저에 등록한 제출값과 value getter가 돌려주는 값이 다르면, 네이티브 제출과 jQuery 요청의 결과도 달라질 수 있다. 이는 소스의 읽기 경로에서 도출한 가정이며 실행으로 재현한 사례는 아니다. 두 경로를 지원할 컴포넌트라면 표시 문자열과 제출값 중 무엇을 value로 노출할지 문서화하겠다.
표준의 제출값은 문자열 외에 File, 여러 항목을 담은 FormData, 제출에서 제외하는 null도 허용한다. 반면 jQuery의 .serializeArray()는 이름·값 배열을 만드는 API이며 파일 입력 데이터는 직렬화하지 않는다. 새 지원을 네이티브 폼 제출 전체와 동등하다는 뜻으로 넓혀 읽기 어려운 이유다. 표준의 제출값, API의 포함·제외 규칙
파일이나 여러 이름의 값을 내보내는 컴포넌트라면 new FormData(form)을 사용하는 경로도 비교할 만하다. 이 생성자는 폼의 제출 항목 목록을 구성하는 표준 절차를 사용한다. 다만 기존 서버가 URL 인코딩된 문자열을 받는다면 요청 형식까지 검토해야 한다. 직렬화 방식만 바꾸고 서버의 해석 계약을 그대로 기대해서는 안 된다. FormData 생성 절차
3.8의 수정과 4.1의 기능을 나눠 판단한다
이번 발표에는 선택자 정규식의 과도한 역추적 문제를 고친 ReDoS 수정도 있다. ReDoS는 특정 입력이 정규식 처리 시간을 크게 늘려 작업을 방해하는 문제다. 이 수정은 4.1.0과 3.8.0 양쪽에 들어갔지만, 폼 연결 커스텀 요소 지원은 4.1.0의 변화다. 두 버전을 같은 기능의 선택지로 보면 안 된다. 버전별 변경 범위
아직 3.x 플러그인에 의존하는 서비스라면 3.8의 수정 적용과 4.x 이전 계획을 나눠 진행할 수 있다. 다만 팀은 3.8을 3.x의 마지막 예정 기능 릴리스로 설명하며, 이후에는 중대한 보안·버그 수정만 제공한다고 밝혔다. 3.x에 남는 판단에는 앞으로 새 기능을 받지 못하는 비용도 포함된다. 지원 방향
3.x에서 4.1로 옮기는 일은 4.0의 변경도 통과하는 작업이다. 공식 이전 가이드는 제거된 API와 브라우저 지원 범위의 변화를 확인하고, 개발용 jQuery Migrate로 경고를 해결한 뒤 Migrate 없이 다시 시험하도록 안내한다. Migrate의 경고가 없다는 사실만으로 우리 커스텀 요소의 제출값까지 검증됐다고 보지는 않겠다. 4.0 이전 가이드
숨은 입력을 지우기 전에 요청 하나를 비교한다
내가 이 기능을 먼저 검토할 곳은 jQuery로 제출하는 기존 폼에 웹 컴포넌트를 점진적으로 넣는 화면이다. 새 화면 전체를 어떤 프레임워크로 만들지 결정하는 문제보다, 기존 제출 경로와 새 컴포넌트가 맞닿는 작은 경계에 가깝다.
누락을 막으려고 같은 이름의 hidden 입력에 값을 복사해 왔다면 더 주의해야 한다. 업그레이드 뒤에는 컴포넌트와 hidden 입력의 값이 함께 수집될 수 있다. 이전 요청에 항목 하나가 있었다는 이유로 새 요청에도 하나만 있으리라 기대할 수는 없다.
대표 폼 하나에서는 다음 순서로 확인하겠다.
- 실제 호출이 폼 전체를 직렬화하는지, 기존 입력 선택자만 순회하는지 확인한다.
- 컴포넌트의
name·value와 내부 제출값이 어떤 관계인지 적고, 정상값·빈값·제출 제외 상태를 비교한다. - 비활성화, 폼 초기화, 같은 이름의 여러 값이 있는 경우에 서버가 받은 항목과 저장 결과를 확인한다.
- 기존 우회용 hidden 입력을 유지한 상태와 제거한 상태를 비교해 누락과 중복이 모두 없는지 확인한다.
특히 같은 이름의 hidden 입력으로 값을 대신 보내던 폼은 주의해서 보겠다. 업그레이드 뒤 커스텀 요소까지 수집되면 두 값이 함께 전송될 수 있다. 서버가 첫 값과 마지막 값 중 무엇을 선택하는지에 따라 조용한 동작 변화가 생길 수 있다는 것이 내 판단이다.
일반 입력만으로 충분하거나 컴포넌트의 제출 규약을 유지할 여력이 없다면 기존 방식을 유지할 이유도 있다. 4.1을 적용할 근거는 지원 목록에 새 항목이 생겼다는 사실보다 구체적이어야 한다. 기존 제출 경로를 보존하면서 우회 코드를 줄일 수 있고, 서버에 도착하는 이름과 값을 설명할 수 있을 때 전환 범위를 넓히겠다.
참고 자료
이 이야기가 도움이 되었나요?