선택 항목인 여유 좌석 수를 비웠는데 서버에 0이 들어갔다면, 먼저 브라우저가 값을 읽은 지점과 요청 객체를 만드는 지점을 비교하세요. 예를 들어 이 화면에서 빈 칸은 “옵션 생략”, 0은 “여유 좌석을 두지 않음”입니다. 둘을 같은 숫자로 바꾸면 서버는 사용자의 선택을 복원할 수 없습니다.
빈 값과 0을 가르는 지점
| 관찰 | 먼저 확인할 값 | 예제의 처리 |
|---|---|---|
| 칸을 지웠는데 요청에는 0 | 빈 문자열을 Number에 넘겼는가 | 변환 전에 생략 상태로 분기 |
| 0을 입력했는데 키가 없음 | if (!n)으로 0도 걸렀는가 | 0을 정상 값으로 유지 |
| 입력이 불완전하고 value가 비어 보임 | validity.badInput과 value를 함께 관찰 | 변환 실패 상태를 빈 칸보다 먼저 판정 |
| 2.5가 숫자로 읽히는데 허용되지 않음 | stepMismatch, min/max, 정수 계약 | 숫자로 읽힌 것과 제출 가능한 값인지 따로 검사 |
| 화면에는 NaN, JSON에는 null | JSON.stringify 직전 값과 자료형 | 유한한 수만 요청 데이터에 포함 |
디버깅할 때는 같은 합성 입력으로 value, valueAsNumber, validity의 해당 항목, 직렬화 직전 객체를 차례로 기록합니다. 숫자를 읽을 수 있는지와 범위·간격에 맞는지는 다른 질문입니다.
브라우저가 읽은 수와 프로젝트의 계약을 나누세요
valueAsNumber는 변환할 수 없으면 NaN을 반환합니다. 빈 값과 변환 불가를 이 값 하나로 구분하지 마세요. 숫자로 변환되지 않는 편집 상태에서는 브라우저가 badInput을 표시할 수 있으며, 직접 value에 잘못된 문자열을 설정하는 시험은 키보드 편집과 같지 않습니다. 표준의 값 정리 규칙으로 인해 빈 문자열이 될 수 있습니다.
Number('')나 공백 문자열의 변환은 0입니다. parseInt는 문자열 앞부분만 읽어 소수나 접미사가 붙은 입력을 통과시킬 수 있습니다. JSON.stringify는 NaN과 Infinity를 null로 바꾸므로 직렬화 성공도 숫자 검증을 대신하지 못합니다.
생략·오류·정상 숫자를 따로 반환하는 예제
설명용 코드는 고정된 숫자 입력 하나를 가정합니다. 여유 좌석 수는 선택 항목이며 허용 범위는 0~12의 정수입니다. 생략은 객체에서 키를 빼고, 명시적인 0은 유지합니다. 사용 중인 API에서 생략이 “기존 값 유지”, null이 “값 삭제”를 뜻한다면 그 계약을 따로 맞춰야 합니다.
function readSpareSeats({ value, valueAsNumber, badInput, stepMismatch,
rangeUnderflow, rangeOverflow }) {
// 이 화면의 계약: 선택 항목, 0~12 사이 정수. 0은 명시적인 입력입니다.
if (badInput) return { state: 'invalid', reason: 'number' };
if (value === '') return { state: 'omitted' };
const n = valueAsNumber;
if (!Number.isFinite(n)) return { state: 'invalid', reason: 'number' };
if (rangeUnderflow || rangeOverflow || n < 0 || n > 12) {
return { state: 'invalid', reason: 'range' };
}
if (stepMismatch || !Number.isInteger(n)) {
return { state: 'invalid', reason: 'whole-number' };
}
return { state: 'ready', value: n };
}
function toSeatOptions(result) {
if (result.state === 'omitted') return {};
if (result.state === 'ready') return { spareSeats: result.value };
throw new Error('유효하지 않은 수량은 요청 데이터로 만들지 않습니다.');
}
아래 HTML은 전송 폼이 아닌 로컬 확인용입니다. 해당 요소와 위 함수를 준비하고, 연결 코드는 요소가 만들어진 뒤 실행하세요. 결과는 화면에만 표시되며 요청을 보내지 않습니다.
<label for="spare-seats">여유 좌석 수 (선택, 0~12)</label>
<input id="spare-seats" type="number" min="0" max="12" step="1">
<button id="inspect" type="button">값 확인</button>
<p id="result" role="status"></p>
// 앞의 함수와 HTML을 준비한 뒤, 요소가 만들어진 시점에 연결합니다.
const field = document.querySelector('#spare-seats');
const output = document.querySelector('#result');
document.querySelector('#inspect').addEventListener('click', () => {
const { badInput, stepMismatch, rangeUnderflow, rangeOverflow } = field.validity;
const result = readSpareSeats({
value: field.value, valueAsNumber: field.valueAsNumber,
badInput, stepMismatch, rangeUnderflow, rangeOverflow,
});
if (result.state === 'invalid') {
output.textContent = '0~12 사이의 정수를 입력하세요.';
return;
}
output.textContent = JSON.stringify(toSeatOptions(result));
});
step은 기준값에서 정해진 간격에 맞는지 검사합니다. 기본 간격이 1이어도 기준값이 소수라면 정수만 유효하다는 뜻은 아닙니다. 여기서는 min=0·step=1을 명시하고 앱 계약에서도 정수 여부를 확인합니다. 우편번호나 좌석 코드처럼 계산하지 않는 식별자는 숫자로 변환하면 앞의 0을 잃을 수 있으므로 별도 문자열 계약을 사용하세요.
직접 확인한 JavaScript 동작과 브라우저에서 남은 확인
2026년 11월 4일 Node.js v24.22.1에서 내장 Number·parseInt·JSON 변환과 위 함수의 합성 입력을 실행했습니다. 빈 값은 {}, 명시적인 0은 {"spareSeats":0}으로 나뉘었습니다. 빈 문자열과 badInput이 함께 있는 합성 입력은 오류로 처리했고, 범위 밖 값·소수·NaN·Infinity는 요청 객체 만들기 전에 거절했습니다. 확인한 것은 함수와 자바스크립트 변환입니다. 브라우저가 어떤 키 입력에서 badInput을 만드는지, 모바일 키보드나 로캘별 입력이 어떻게 동작하는지는 시험하지 않았습니다.
- 대상 브라우저에서 값 비우기, 0, 12, 13, 2.5를 각각 입력하고 화면 결과를 비교합니다.
- 입력 중인 마이너스 기호나 지수 표기를 브라우저가 허용하는지 직접 확인합니다. 편집 도중의 상태와 입력을 마친 뒤 상태를 나눠 기록합니다.
- 숫자 표시가 다른 로캘에서도 입력창에 보이는 문자열과 DOM의 value가 반드시 같다고 가정하지 않습니다.
- 실제 API에 연결할 때는 테스트 환경에서 키 없음·숫자 0·null·문자열 “0”을 구분하고 서버도 정수와 범위를 검사하는지 확인합니다. 이번에는 서버·DB까지 실행하지 않았습니다.
같은 숫자 문제처럼 보일 때 어디를 볼지
필드 자체가 요청에서 누락된다면 FormData 수집 경계, 수신한 JSON의 타입이 틀리다면 Dart JSON 파싱, 소수 단위 금액 계산이 어긋난다면 부동소수점과 금액을 확인하세요. 이 글은 HTML 숫자 입력을 읽어 선택 항목의 요청 객체를 만드는 경계에 초점을 둡니다.
확인한 표준과 문서
2026년 11월 4일 아래 원문을 대조했습니다. 0~12의 좌석 수 계약과 합성 입력 비교는 이 글의 예제입니다.