萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 安全加法函數實現:參數驗證、類型檢查與異常處理完整指南

為什麼需要專門的加法函數?

JS 中 + 運算符同時用於數字加法和字符串拼接,且隱式類型轉換規則複雜(如 [] + {}、"1" + 2)。專用加法函數可:

  • 嚴格校驗參數類型(必須為有效數字)
  • 提供清晰的錯誤信息定位問題
  • 避免隱式轉換導致的業務邏輯錯誤
  • 統一異常處理流程

核心實現(重構優化版)

function safeAdd(arg1, arg2) {
    // 1. 空值檢查
    if (arg1 === '' || arg1 === null || arg1 === undefined) {
        throw createError(1000001, '第 1 個參數為空或未定義');
    }
    if (arg2 === '' || arg2 === null || arg2 === undefined) {
        throw createError(1000002, '第 2 個參數為空或未定義');
    }

    // 2. 類型轉換與合法性檢查
    const num1 = toValidNumber(arg1, 1);
    const num2 = toValidNumber(arg2, 2);

    // 3. 精度處理(可選:解決 0.1+0.2 問題)
    return preciseAdd(num1, num2);
}

function toValidNumber(val, index) {
    const str = String(val).trim();
    // 正則驗證:支持整數、小數、科學計數法、正負號
    if (!/^[-+]?(\d+(\.\d*)?|\.\d+)([eE][-+]?\d+)?$/.test(str)) {
        throw createError(1000001 + index, `參數 ${index} "${val}" 不是合法數字`);
    }
    return Number(str);
}

function preciseAdd(a, b) {
    // 簡易精度修正:按小數位對齊
    const [, dec1 = ''] = String(a).split('.');
    const [, dec2 = ''] = String(b).split('.');
    const factor = Math.pow(10, Math.max(dec1.length, dec2.length));
    return (Math.round(a * factor) + Math.round(b * factor)) / factor;
}

function createError(code, message) {
    const err = new Error(message);
    err.code = code;
    return err;
}

HTML 交互示例

<input type="text" id="num1" placeholder="加數 1" style="width: 80px"> +
<input type="text" id="num2" placeholder="加數 2" style="width: 80px"> =
<input type="text" id="result" readonly style="width: 80px">
<button id="calcBtn">計算</button>

<script>
$('#calcBtn').click(() => {
    try {
        const val1 = $('#num1').val();
        const val2 = $('#num2').val();
        const sum = safeAdd(val1, val2);
        $('#result').val(sum);
    } catch (e) {
        alert(`錯誤 [${e.code}]: ${e.message}`);
    }
});
</script>

原文代碼問題分析

問題原文寫法改進方案
數字檢查邏輯雙層循環逐字符對比 0-9正則表達式一次性驗證,支持小數、負數、科學計數法
錯誤碼衝突所有錯誤統一用 1000001區分錯誤碼:1000001/1000002/1000003
拼寫錯誤e.Serail (少了 i)統一用 e.code
字符串轉數字Number(arg1) 直接轉先驗證再轉換,避免 Number("") === 0 隱患
精度丟失無處理提供 preciseAdd 簡易修正

進階擴展:通用數學運算封裝

const SafeMath = {
    add: (a, b) => preciseAdd(toValidNumber(a), toValidNumber(b)),
    subtract: (a, b) => preciseAdd(toValidNumber(a), -toValidNumber(b)),
    multiply: (a, b) => {
        const n1 = toValidNumber(a), n2 = toValidNumber(b);
        const [, d1 = ''] = String(n1).split('.');
        const [, d2 = ''] = String(n2).split('.');
        const factor = Math.pow(10, d1.length + d2.length);
        return Math.round(n1 * factor) * Math.round(n2 * factor) / factor;
    },
    divide: (a, b) => {
        const n2 = toValidNumber(b);
        if (n2 === 0) throw createError(1000003, '除數不能為零');
        return toValidNumber(a) / n2;
    }
};

總結

安全加法函數的核心價值在於「失敗快、定位準、恢復易」。實際項目中,建議:

  1. 使用成熟庫(如 decimal.js、big.js)處理高精度計算
  2. 表單層面用 HTML5 type="number" + step 做首輪攔截
  3. 業務層統一異常碼規範,便於監控告警
  4. 單元測試覆蓋邊界值:0, -0, NaN, Infinity, "", null, undefined, "abc", "1.2.3"
copyright © 萬盛學電腦網 all rights reserved