來源格式與預期記錄
這是原創假設轉換例子。輸入限下列欄位的普通、無循環 JSON 形記錄,統一記錄格式及拒絕代碼由本例訂明。若換來源,先修改格式約定。
本例 flags 只可有 setup、training、export,三欄必須都有且為布林。按此固定次序列為真的項目,原三欄全部保存。欠欄、未知欄或非布林便拒絕。全為假也是完整選擇記錄,selected 為空。
| 個案 | 輸入記錄(JSON) | 預期輸出(JSON) |
|---|---|---|
| 整理已選布林欄位 | {"flags":{"setup":true,"training":false,"export":true}} | {"ok":true,"value":{"selected":["setup","export"],"sourceFlags":{"setup":true,"training":false,"export":true}}} |
| 拒絕缺漏選項值 | {"flags":{"setup":true,"training":false}} | {"ok":false,"error":"FLAG_MISSING"} |
| 保留全部未選 | {"flags":{"setup":false,"training":false,"export":false}} | {"ok":true,"value":{"selected":[],"sourceFlags":{"setup":false,"training":false,"export":false}}} |
在本機執行轉換
把完整例子以 JavaScript 模組在 Node.js 執行,內含純轉換函數、三個輸入及寫明的預期輸出,對不上便由斷言停止。拒絕個案回傳 ok=false 及代碼,不回傳半份統一記錄。
import assert from 'node:assert/strict';
function serviceFlags(i){
const fail=error=>({ok:false,error});if(!i||!i.flags||typeof i.flags!=='object'||Array.isArray(i.flags))return fail('FLAG_OBJECT');
const keys=['setup','training','export'];
if(Object.keys(i.flags).some(k=>!keys.includes(k)))return fail('FLAG_UNKNOWN');
if(keys.some(k=>!Object.hasOwn(i.flags,k)))return fail('FLAG_MISSING');
if(keys.some(k=>typeof i.flags[k]!=='boolean'))return fail('FLAG_VALUE');
return {ok:true,value:{selected:keys.filter(k=>i.flags[k]),sourceFlags:{setup:i.flags.setup,training:i.flags.training,export:i.flags.export}}};
}
// Original synthetic cases; expected outputs are literal records.
const cases = [
{
"label": "Decode selected flag fields",
"input": {
"flags": {
"setup": true,
"training": false,
"export": true
}
},
"expected": {
"ok": true,
"value": {
"selected": [
"setup",
"export"
],
"sourceFlags": {
"setup": true,
"training": false,
"export": true
}
}
}
},
{
"label": "Reject missing flag",
"input": {
"flags": {
"setup": true,
"training": false
}
},
"expected": {
"ok": false,
"error": "FLAG_MISSING"
}
},
{
"label": "Preserve all-false selection",
"input": {
"flags": {
"setup": false,
"training": false,
"export": false
}
},
"expected": {
"ok": true,
"value": {
"selected": [],
"sourceFlags": {
"setup": false,
"training": false,
"export": false
}
}
}
}
];
for (const sample of cases) {
const actual = serviceFlags(sample.input);
assert.deepEqual(actual, sample.expected);
console.log(sample.label, JSON.stringify(actual));
}
判清邊界個案
欠 export 為何拒絕,export=false 卻有效?
查看參考答案
缺漏沒有答案,false 是明確未選。首個案選 setup、export,仍保存 training=false;轉換本身未下服務訂單。