입력창에는 값이 보이는데 서버에서 누락됐다고 나오면 폼 수집 전부터 빠졌는지, 변환 중 지워졌는지, 서버 해석에서 달라졌는지 먼저 나누세요. name이 없는 입력, disabled 상태, 선택하지 않은 체크박스는 화면에 있다는 이유만으로 수집되지 않습니다. 반대로 같은 name의 여러 값은 수집됐어도 일반 객체로 바꾸면서 하나만 남을 수 있습니다.
이 글은 파일 전송량이 아닌 HTML 폼의 문자열 필드 수집에 집중합니다. 파일 선택값을 먼저 지운 경우는 파일 선택·초기화 글, 이미 보낸 요청의 413·multipart 문제는 업로드 오류 글에서 따로 확인하세요.
빠진 값을 세 지점에서 비교하세요
| 처음 달라지는 지점 | 관찰 | 확인할 조건 |
|---|---|---|
| new FormData(form) 직후 | 원하는 키가 없음 | name·form 소유자·disabled·체크 상태·수집 시점 |
| 배열·JSON 변환 뒤 | 같은 name의 값이 하나로 줄어듦 | get/getAll, Object.fromEntries, set 사용 |
| 실제 요청 payload | 화면에서 확인한 객체와 다름 | 과거 객체 재사용·후속 수정·다른 body 전송 여부 |
| 서버 파싱 결과 | payload에는 있지만 앱 값에는 없음 | 필드명·다중 값 규칙·검증·파서·Content-Type |
| submit 핸들러까지 안 옴 | 요청도 새 수집도 없음 | 필수 입력 검증, 버튼 type, 직접 submit() 호출 여부 |
실제 폼의 전체 payload를 운영 로그에 남기지 마세요. 재현에는 합성 값만 사용하고, 사용자 폼은 허용된 필드의 존재 여부·개수·오류 분류를 먼저 기록합니다. 값이 없는 키와 빈 문자열인 키도 구분해야 누락과 사용자의 빈 입력을 같은 문제로 처리하지 않습니다.
name과 disabled는 표시 상태와 다릅니다
HTML의 entry list 규칙은 해당 form에 속한 컨트롤 중 어떤 항목을 넣는지 정의합니다. 일반 입력은 id나 label이 아니라 비어 있지 않은 name으로 키가 정해집니다. 요소가 다른 form에 속해 있으면 눈으로 가까워 보여도 그 폼을 수집할 때 포함되지 않습니다.
disabled인 컨트롤과 선택되지 않은 checkbox·radio, 해당 submitter가 아닌 버튼은 제외 조건을 확인해야 합니다. 상위 fieldset의 disabled도 영향을 주므로 자식 input에 disabled 속성이 없다는 것만 보지 마세요. 다만 비활성 fieldset의 첫 legend 안에 있는 컨트롤은 예외가 있으므로 “안에 있으면 전부 누락”이라고 단정하지 않습니다.
readonly 문서처럼 지원되는 텍스트 입력의 readonly는 disabled와 다릅니다. 제출에 필요한 값을 편집만 막으려는 경우에 검토할 수 있지만 select·checkbox에 같은 효과가 있다고 가정하지 마세요. disabled나 readonly는 브라우저 UI 규칙이며 서버 권한·신뢰 검증을 대신하지 않습니다.
수집한 뒤 잠그고, 누른 버튼을 함께 넘기세요
FormData 생성자는 생성 시점의 현재 값을 사용합니다. 전체 필드를 disabled로 만든 다음 수집하면 필요한 값이 빠질 수 있습니다. 먼저 data를 만든 뒤 필요한 UI 잠금을 처리하고, 한참 전에 만든 data가 이후 화면 편집을 자동으로 따라온다고 기대하지 않습니다. data 자체를 set·append·delete하거나 formdata 리스너에서 바꾼 경우는 별도로 추적합니다.
제출 버튼에 name·value가 있고 그 값이 필요하다면 submit 이벤트의 submitter를 생성자 두 번째 인자로 전달합니다. 아무 버튼이나 넣을 수 있는 것이 아니며, 그 폼에 속한 제출 버튼이어야 합니다. 지원 브라우저와 두 번째 인자 호환성도 프로젝트 대상 환경에서 확인하세요.
아래 HTML과 collect.js는 같은 폴더에서 함께 검토할 실행할 수 있는 예제입니다. 합성 값만 입력하세요. JavaScript가 정상 연결된 submit 핸들러는 기본 제출을 막고 결과만 textContent로 표시하며 fetch·XHR을 호출하지 않습니다. 이 사이트 본문에서 실행되는 기능이 아니고, 스크립트가 누락된 일반 폼의 기본 제출까지 막는다고 주장하지 않습니다.
<form id="entry">
<fieldset id="fields">
<legend>합성 데이터 입력</legend>
<label>제목 <input id="title" name="title" value="기록 A" required></label>
<label>기록 번호 <input name="recordId" value="demo-42" readonly></label>
<label>이름 없는 표시값 <input value="표시만 하는 값"></label>
<label>비활성 값 <input name="quota" value="10" disabled></label>
<label><input type="checkbox" name="tag" value="web" checked>Web</label>
<label><input type="checkbox" name="tag" value="android" checked>Android</label>
<label><input type="checkbox" name="sendCopy" value="yes">사본 받기</label>
</fieldset>
<fieldset disabled>
<legend>비활성 묶음 <input name="legendFlag" value="kept" aria-label="첫 legend 안의 값"></legend>
<label>묶음 안의 값 <input name="groupNote" value="blocked"></label>
</fieldset>
<button type="submit" name="intent" value="inspect">수집 A</button>
<button type="submit" name="intent" value="compare">수집 B</button>
</form>
<p id="status" role="status">아직 수집하지 않았습니다.</p>
<pre id="result" aria-label="수집 결과"></pre>
<script src="collect.js" defer></script>
const form = document.querySelector('#entry');
const status = document.querySelector('#status');
const result = document.querySelector('#result');
function showData(data, mode) {
result.textContent = JSON.stringify({
mode,
entries: [...data.entries()],
tags: data.getAll('tag'),
// 아래 값은 손실 비교용입니다. 전송용 변환으로 쓰지 마세요.
lastTagAfterObjectConversion: Object.fromEntries(data).tag ?? null,
}, null, 2);
}
form.addEventListener('submit', (event) => {
event.preventDefault(); // 이 예제는 서버로 전송하지 않습니다.
const data = event.submitter
? new FormData(form, event.submitter)
: new FormData(form);
// data를 만든 뒤에 필요한 UI 잠금을 처리합니다.
showData(data, 'submit');
status.textContent = '브라우저에서 수집했습니다. 서버 저장 결과가 아닙니다.';
});
HTML 규칙으로 예상하면 수집 A에는 title·recordId·tag 두 값·legendFlag와 intent=inspect가 들어갑니다. 이름 없는 표시값·quota·선택하지 않은 sendCopy·비활성 묶음의 groupNote는 제외 대상입니다. 수집 B는 intent=compare로 달라집니다. 아래 브라우저 시험에서 이 결과를 확인했습니다.
중복 name을 객체 하나로 줄이지 마세요
getAll은 그 키의 값들을 배열로 읽습니다. get은 첫 값을 읽는 용도이고 Object.fromEntries는 같은 키를 가진 객체 속성 하나로 줄여 버릴 수 있습니다. 위 예제의 lastTagAfterObjectConversion은 이 손실을 비교하려는 출력이며 전송용 변환으로 사용하지 않습니다.
append와 set도 역할이 다릅니다. append는 같은 키를 추가하고 set은 그 키의 기존 값들을 대체합니다. JSON API가 배열을 요구한다면 허용된 필드별로 getAll과 타입 검증을 적용한 명시적 payload를 만드세요. 체크되지 않아 없는 키를 false로 바꿀지, 생략으로 유지할지는 서버 계약에 따라 정합니다.
FormData를 JSON.stringify에 그대로 넘기면 entry 직렬화가 되었다고 볼 수 없습니다. 파일·Blob이 포함된 데이터는 문자열 필드만 있는 예제와 달리 별도 처리가 필요합니다. FormData를 요청 body로 직접 전송한다면 MDN 전송 안내처럼 multipart boundary가 포함될 Content-Type을 브라우저가 만들도록 두세요.
10월 31일 Node의 문자열 값 처리 검사
2026년 10월 31일 Node.js v24.22.1의 실제 FormData를 사용해 문자열 값을 직접 append한 검사 8건을 실행했고 모두 통과했습니다. FormData를 모의 객체로 대체하지 않았습니다. 그러나 Node에는 이 예제의 HTMLFormElement 수집을 실행하지 않았으므로 disabled·checkbox·submitter와 브라우저 입력 검증의 통과 결과로 확대하지 않습니다.
| 직접 실행한 입력 | 관찰 결과 |
|---|---|
| tag에 web, android를 append | getAll은 [web, android], get은 web, entry 두 개 유지 |
| 위 데이터를 Object.fromEntries로 변환 | tag가 android 하나만 남음, 원래 FormData는 두 값 유지 |
| 같은 키를 desktop으로 set | getAll이 [desktop]으로 대체됨 |
| 없는 note와 note에 빈 문자열 추가 비교 | has=false/get=null과 has=true/get=빈 문자열 구분 |
| 0과 false를 append | 문자열 “0”, “false”로 관찰 |
| entry 배열 복사 뒤 FormData 수정 | 복사 배열 A, 원래 객체 현재 값 B로 분리 |
| title=A인 FormData를 JSON.stringify | 그대로는 {}, entry 배열을 직렬화하면 title 쌍 포함 |
Chrome에서 폼 수집 순서를 확인했습니다
2026년 11월 15일 Chrome 157.0.8103.78 헤드리스에서 위 HTML과 collect.js를 로컬 서버로 열고 합성 입력과 실제 제출 버튼으로 확인했습니다.
| 조작 | 관찰 결과 |
|---|---|
| 수집 A | title, recordId, 두 tag, legendFlag, intent=inspect가 포함됐습니다. 이름 없는 값, quota, sendCopy, groupNote는 빠졌습니다. 일반 객체로 바꾼 비교 출력에는 마지막 태그 android만 남았습니다. |
| 수집 B | 누른 버튼의 값에 따라 intent=compare가 포함됐습니다. |
| Android 체크를 해제하고 수집 A | getAll('tag')에 web만 남았습니다. |
| 제목을 비우고 수집 A | 필수 입력 검증으로 제출 처리기가 호출되지 않아 이전 출력이 유지됐습니다. 같은 폼에서 생성자를 직접 호출하면 title의 빈 문자열은 수집됐습니다. |
| 잠그기 전과 후에 각각 수집하고 잠금을 풀어 제목 수정 | 잠근 뒤 수집한 값에는 제목이 없었습니다. 잠그기 전 객체에는 당시 제목이 남았고, 새 객체에는 수정한 제목이 들어갔습니다. 버튼을 인자로 넘기지 않은 생성자에는 intent가 없었습니다. |
확인 범위는 로컬 폼의 수집과 브라우저 검증입니다. 파일 업로드와 서버 파싱·저장은 별도 확인이 필요합니다.
대상 브라우저에서 이 비교를 마치세요
- 합성 데이터로 A·B 버튼을 각각 눌러 entries와 intent를 비교합니다. 수집 완료를 서버 저장 성공으로 표시하지 않습니다.
- Android 체크를 해제하고 tag 개수 변화를 확인합니다. 체크되지 않은 sendCopy가 없는 것과 false 문자열이 있는 것을 혼동하지 않습니다.
- 필드 수집 전·후에 fieldset을 잠그는 경우를 각각 비교합니다. 검증을 위해 원래 잠금 상태를 보존하고 되돌리는 동작도 확인합니다.
- 값 A에서 data를 만든 뒤 입력을 B로 고치고, 보관한 data와 새로 만든 data를 비교합니다. formdata 리스너가 값을 추가·삭제한다면 그 시점도 함께 기록합니다.
- title을 비워 기본 검증으로 submit이 막히는지 확인합니다. submit 이벤트 문서처럼 검증 실패는 submit에 도달하지 않을 수 있습니다. new FormData 호출 자체를 검증 성공으로 해석하지 않습니다.
- 프로그램에서 제출할 때는 requestSubmit과 직접 submit의 검증·이벤트 차이를 확인합니다. 검증을 우회해 값 누락을 숨기는 해결책으로 쓰지 않습니다.
- 수집값이 맞으면 그다음 실제 요청과 서버 파싱을 별도로 대조합니다. 다중 값 이름과 빈 값 처리 계약을 프레임워크별로 확인하고 서버 검증을 유지합니다.
공식 원문과 확인 범위
2026년 10월 31일 아래 HTML 표준과 MDN 원문을 직접 열어 대조했습니다. 11월 15일에는 HTML 수집 규칙과 FormData 생성자 문서를 다시 확인하고 로컬 Chrome에서 위 폼을 실행했습니다.