웹 숫자 입력에서 빈 값이 0이 될 때: valueAsNumber·NaN·범위 검증

선택 항목인 여유 좌석 수를 비웠는데 서버에 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을 만드는지, 모바일 키보드나 로캘별 입력이 어떻게 동작하는지는 시험하지 않았습니다.

  1. 대상 브라우저에서 값 비우기, 0, 12, 13, 2.5를 각각 입력하고 화면 결과를 비교합니다.
  2. 입력 중인 마이너스 기호나 지수 표기를 브라우저가 허용하는지 직접 확인합니다. 편집 도중의 상태와 입력을 마친 뒤 상태를 나눠 기록합니다.
  3. 숫자 표시가 다른 로캘에서도 입력창에 보이는 문자열과 DOM의 value가 반드시 같다고 가정하지 않습니다.
  4. 실제 API에 연결할 때는 테스트 환경에서 키 없음·숫자 0·null·문자열 “0”을 구분하고 서버도 정수와 범위를 검사하는지 확인합니다. 이번에는 서버·DB까지 실행하지 않았습니다.

같은 숫자 문제처럼 보일 때 어디를 볼지

필드 자체가 요청에서 누락된다면 FormData 수집 경계, 수신한 JSON의 타입이 틀리다면 Dart JSON 파싱, 소수 단위 금액 계산이 어긋난다면 부동소수점과 금액을 확인하세요. 이 글은 HTML 숫자 입력을 읽어 선택 항목의 요청 객체를 만드는 경계에 초점을 둡니다.

확인한 표준과 문서

2026년 11월 4일 아래 원문을 대조했습니다. 0~12의 좌석 수 계약과 합성 입력 비교는 이 글의 예제입니다.