來源格式與預期記錄
這是原創假設轉換例子。輸入限下列欄位的普通、無循環 JSON 形記錄,統一記錄格式及拒絕代碼由本例訂明。若換來源,先修改格式約定。
來源只接納 g、kg 及最多三位小數的非負數字文字;不用千位符或指數,整數部分除 0 外不以零開頭。先按數字拆出千分之一,再轉成安全整數毫克,原數值及單位照存。四位小數超出本例格式,即使可作更細計算也拒絕。
| 個案 | 輸入記錄(JSON) | 預期輸出(JSON) |
|---|---|---|
| 按小數位精確換算 | {"value":"1.250","unit":"kg"} | {"ok":true,"value":{"milligrams":1250000,"source":{"value":"1.250","unit":"kg"}}} |
| 拒絕超出精度 | {"value":"1.0001","unit":"g"} | {"ok":false,"error":"MASS_DECIMAL"} |
| 保留零重量 | {"value":"0","unit":"g"} | {"ok":true,"value":{"milligrams":0,"source":{"value":"0","unit":"g"}}} |
在本機執行轉換
把完整例子以 JavaScript 模組在 Node.js 執行,內含純轉換函數、三個輸入及寫明的預期輸出,對不上便由斷言停止。拒絕個案回傳 ok=false 及代碼,不回傳半份統一記錄。
import assert from 'node:assert/strict';
function massToMilligrams(i){
const fail=error=>({ok:false,error});if(!i||typeof i.value!=='string'||!['g','kg'].includes(i.unit))return fail('MASS_UNIT');
const m=/^(0|[1-9]\d*)(?:\.(\d{1,3}))?$/.exec(i.value);if(!m)return fail('MASS_DECIMAL');
const thousandths=Number(m[1])*1000+Number((m[2]||'').padEnd(3,'0'));
const milligrams=thousandths*(i.unit==='kg'?1000:1);
if(!Number.isSafeInteger(thousandths)||!Number.isSafeInteger(milligrams))return fail('MASS_RANGE');
return {ok:true,value:{milligrams,source:{value:i.value,unit:i.unit}}};
}
// Original synthetic cases; expected outputs are literal records.
const cases = [
{
"label": "Scale decimal exactly",
"input": {
"value": "1.250",
"unit": "kg"
},
"expected": {
"ok": true,
"value": {
"milligrams": 1250000,
"source": {
"value": "1.250",
"unit": "kg"
}
}
}
},
{
"label": "Reject excess precision",
"input": {
"value": "1.0001",
"unit": "g"
},
"expected": {
"ok": false,
"error": "MASS_DECIMAL"
}
},
{
"label": "Preserve zero mass",
"input": {
"value": "0",
"unit": "g"
},
"expected": {
"ok": true,
"value": {
"milligrams": 0,
"source": {
"value": "0",
"unit": "g"
}
}
}
}
];
for (const sample of cases) {
const actual = massToMilligrams(sample.input);
assert.deepEqual(actual, sample.expected);
console.log(sample.label, JSON.stringify(actual));
}
判清邊界個案
1.250 kg 轉成多少?1.0001 g 為何拒絕?
查看參考答案
1.250 × 1,000,000 = 1,250,000 mg。後者超過本例三位小數上限,回傳 MASS_DECIMAL,不四捨五入。