以單次替換產生簡單範本文字

來源格式與預期記錄

這是原創假設轉換例子。輸入限下列欄位的普通、無循環 JSON 形記錄，統一記錄格式及拒絕代碼由本例訂明。若換來源，先修改格式約定。

本例自訂範本用 {key}，key 以小寫字母開頭，之後可有小寫字母、數字或底線；其他大括號格式不合法。每個引用 key 要有文字值。只替換一次，按首次使用次序記 usedKeys，其他輸入記 unusedKeys。替換值當普通文字，不再當範本。

可修改的假設轉換個案
個案	輸入記錄（JSON）	預期輸出（JSON）
按原訂純文字語法填值	{"template":"Hi {name}; ref {ref}.","values":{"name":"Ada","ref":"R1"}}	{"ok":true,"value":{"rendered":"Hi Ada; ref R1.","usedKeys":["name","ref"],"unusedKeys":[]}}
拒絕欠佔位值	{"template":"Hi {name}; ref {ref}.","values":{"name":"Ada"}}	{"ok":false,"error":"TEMPLATE_VALUE"}
替代內容保留字面值	{"template":"Hi {name}","values":{"name":"{ref}","ref":"R1"}}	{"ok":true,"value":{"rendered":"Hi {ref}","usedKeys":["name"],"unusedKeys":["ref"]}}

下載可編輯 CSV ↓

在本機執行轉換

把完整例子以 JavaScript 模組在 Node.js 執行，內含純轉換函數、三個輸入及寫明的預期輸出，對不上便由斷言停止。拒絕個案回傳 ok=false 及代碼，不回傳半份統一記錄。

完整函數及可執行個案

import assert from 'node:assert/strict';

function textTemplate(i){
  const fail=error=>({ok:false,error});if(!i||typeof i.template!=='string'||!i.values||typeof i.values!=='object'||Array.isArray(i.values))return fail('TEMPLATE_SHAPE');
  const pattern=/\{([a-z][a-z0-9_]*)\}/g;
  if(/[{}]/.test(i.template.replace(pattern,'')))return fail('TEMPLATE_SYNTAX');
  const usedKeys=[];let error;
  const rendered=i.template.replace(pattern,(_,key)=>{
    if(!Object.hasOwn(i.values,key)||typeof i.values[key]!=='string'){error='TEMPLATE_VALUE';return '';}
    if(!usedKeys.includes(key))usedKeys.push(key);return i.values[key];
  });
  if(error)return fail(error);
  return {ok:true,value:{rendered,usedKeys,unusedKeys:Object.keys(i.values).filter(k=>!usedKeys.includes(k))}};
}

// Original synthetic cases; expected outputs are literal records.
const cases = [
  {
    "label": "Render original plain-text grammar",
    "input": {
      "template": "Hi {name}; ref {ref}.",
      "values": {
        "name": "Ada",
        "ref": "R1"
      }
    },
    "expected": {
      "ok": true,
      "value": {
        "rendered": "Hi Ada; ref R1.",
        "usedKeys": [
          "name",
          "ref"
        ],
        "unusedKeys": []
      }
    }
  },
  {
    "label": "Reject missing token value",
    "input": {
      "template": "Hi {name}; ref {ref}.",
      "values": {
        "name": "Ada"
      }
    },
    "expected": {
      "ok": false,
      "error": "TEMPLATE_VALUE"
    }
  },
  {
    "label": "Preserve replacement text literally",
    "input": {
      "template": "Hi {name}",
      "values": {
        "name": "{ref}",
        "ref": "R1"
      }
    },
    "expected": {
      "ok": true,
      "value": {
        "rendered": "Hi {ref}",
        "usedKeys": [
          "name"
        ],
        "unusedKeys": [
          "ref"
        ]
      }
    }
  }
];
for (const sample of cases) {
  const actual = textTemplate(sample.input);
  assert.deepEqual(actual, sample.expected);
  console.log(sample.label, JSON.stringify(actual));
}

下載可執行例子 ↓

判清邊界個案

name 的值是 "{ref}"，是否再把 ref 替換一次？

查看參考答案

不會。"Hi {name}" 直接變成 "Hi {ref}"。usedKeys 只列 name，ref 仍未使用；真正引用的欄位欠值則 TEMPLATE_VALUE 拒絕。

來源格式與預期記錄

在本機執行轉換

判清邊界個案

相關資源