HOWTO · JavaScript

在 JavaScript 中驗證表單輸入中的數字

本文將教你如何在 JavaScript 中驗證數字。我們將使用正規表示式和 JavaScript 函式,包括 isNaN、parseFloat 和 isFinite。

本頁內容

在 HTML 表單中驗證數字時,請先決定表單要接受哪些字串。整數、帶正負號的小數,以及前後有空白的字串,都是不同的格式。接著在表單提交時驗證完整輸入;輸入期間提供回饋很有幫助,但不能取代最後這項檢查。

決定哪些輸入算是數字

JavaScript 可以將許多字串轉換成數字,但能否轉換並不能決定表單的驗證規則。例如,Number(" ") 會得到 0,而 Number("12px") 會得到 NaN。請決定是否接受正負號、小數、指數記號、前後空白,以及空輸入。如果應用程式需要的是正整數,就應明確強制這項規則,而不是把 JavaScript 能轉換的所有值都視為可接受。

使用正規表示式驗證完整輸入

當你刻意將可接受的格式限定得很明確時,正規表示式就很實用。下方模式允許開頭有選擇性的正負號,後面接一個或多個數字。RegExp.prototype.test() 會以布林值表示是否符合模式。

執行這個範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

const wholeNumber = /^[+-]?\d+$/;
const value = "-42";
console.log(wholeNumber.test(value));

這個模式接受 -42,拒絕 42x 和 2.5;它不會限制數值範圍。JavaScript 的 $ 錨點也可能在字串最後的行終止符之前就符合,因此應搭配明確檢查來排除行終止符。下方函式除了拒絕數字後方的其他文字,也會拒絕該終止符:

const wholeNumber = /^[+-]?\d+$/;
const isWholeNumber = value =>
  wholeNumber.test(value) && !/[\r\n\u2028\u2029]$/.test(value);

console.log(isWholeNumber("-42"));
console.log(isWholeNumber("42x"));
console.log(isWholeNumber("2.5"));
console.log(isWholeNumber("42\n"));

這項格式檢查不會設定數值範圍。如果允許小數,請明確定義其語法,例如 3.、.5 或 -0.5 是否算有效輸入。不要用 /\d/ 這類模式驗證整個輸入;它只會找出字串中任意位置的一個數字。

範例中的可見文字標籤仍是英文,因為程式碼區塊會逐字保留。

使用 JavaScript 數字檢查驗證數字字串

若輸入格式符合 JavaScript 的數字轉換規則,先轉換一次,再檢查結果。Number.isFinite() 會拒絕 NaN、正負無限大,以及非數字值。Number.isNaN() 則專門用來辨識 NaN。相較之下,全域 isNaN() 會強制轉換引數,因此像空白這類字串可能會被當成數字。

完整值檢查可以先移除前後空白、拒絕空字串,再用 Number() 轉換剩餘文字,並確認結果是有限數值。下方範例會先刻意將可接受的文字限制為帶正負號的小數或指數記號,再進行轉換;因此,即使 Number() 能轉換 0x10 這類字串,範例仍會排除它們。parseFloat() 通常不適合單獨用來驗證,因為它接受數字前綴,所以 12px 會被解析為 12。

本節中的程式碼以及顯示的標籤或輸出仍為英文。

function isDecimalNumber(value) {
  const trimmed = value.trim();
  const decimal = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
  if (trimmed === "" || !decimal.test(trimmed)) return false;
  return Number.isFinite(Number(trimmed));
}

const examples = ["", "12.5", "1e3", "12px"];
for (const value of examples) {
  console.log(`${JSON.stringify(value)}: ${isDecimalNumber(value)}`);
}

在這裡,空輸入和尾隨文字都會驗證失敗,而 12.5 和 1e3 會通過。Number.isNaN() 可以辨識 NaN 結果,但 Number.isFinite() 還能排除無限大,因此適合作為此處的最後檢查。

如需進一步了解這項差異,請參閱檢查字串是否為數字。

範例中的可見文字標籤仍是英文,因為程式碼區塊會逐字保留。

在使用者輸入時驗證

監聽 input 事件,並在欄位內容變動時更新提示狀態。讀取欄位目前的 .value,再套用與表單提交時相同的完整值規則。下方精簡的瀏覽器範例會在使用者編輯時以禮貌方式更新狀態,並在表單提交時再次檢查:

範例中的可見文字標籤仍是英文,因為程式碼區塊會逐字保留。

本節中的程式碼以及顯示的標籤或輸出仍為英文。

<form id="number-form">
  <label for="amount">Amount</label>
  <input id="amount" name="amount" type="text" inputmode="decimal">
  <p id="number-feedback" aria-live="polite">Enter a decimal number.</p>
  <button type="submit">Submit</button>
</form>
<script>
  const form = document.querySelector("#number-form");
  const field = document.querySelector("#amount");
  const feedback = document.querySelector("#number-feedback");

  function isDecimalNumber(value) {
    const trimmed = value.trim();
    const decimal = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
    return trimmed !== "" && decimal.test(trimmed) &&
      Number.isFinite(Number(trimmed));
  }

  field.addEventListener("input", () => {
    const value = field.value;
    feedback.textContent = value.trim() === ""
      ? "Enter a decimal number."
      : isDecimalNumber(value)
        ? "This value is ready to submit."
        : "Enter a signed decimal or exponent value.";
  });

  form.addEventListener("submit", event => {
    if (!isDecimalNumber(field.value)) {
      event.preventDefault();
      feedback.textContent = "Enter a valid decimal number before submitting.";
      field.focus();
    }
  });
</script>

每次編輯後,input 處理器都會檢查欄位目前的完整值;它不會逐一過濾按鍵。欄位空白時會顯示提示,而使用者尚未輸入完成的值可以先顯示暫時指引。提交表單時會再次套用相同規則,並阻止送出不符合規則的值。

不要單獨驗證使用者準備輸入的字元:使用者可能會貼上、刪除或選取文字,也可能使用輔助科技,或透過手機鍵盤輸入。逐字元過濾也可能讓使用者無法修正輸入期間暫時不完整的值。

請區分輸入期間的暫時回饋與表單最終的判定。小數在輸入過程中可能暫時不完整,完成後才有效。提交時,請驗證最後的字串、顯示清楚的訊息,並在不符合所選規則時阻止提交。required、min、max 和 step 等 HTML 原生限制也能提供協助,但對你所依賴的資料仍須進行伺服器端驗證。

測試邊界情況並選擇合適方法

請使用代表性值測試表單實際要強制執行的規則。除非模式允許,僅接受數字的模式會拒絕 2.5、-2 和前後有空白的字串。數字轉換可以接受小數,但必須明確拒絕空字串,因為空白字串轉換後會得到零。即使表單不接受指數記號,1e3 仍會轉換為有限數值。同樣地,轉換本身不會強制要求數值為正,也不會限制最大值。

當文字格式很重要時,請使用正規表示式;當數值意義很重要時,請使用數字轉換並加上範圍檢查。無論採用哪種方法,都應測試空輸入、有效整數、允許的小數、正負號、尾隨字母,以及表單相關的邊界值。將這些案例保留在應用程式測試中,避免日後修改不知不覺擴大表單接受的輸入範圍。