將 HTML 模板、SQL 語句、詩詞歌賦等大段文本內嵌 JS 時,傳統寫法極其痛苦:
// 傳統拼接法:轉義、引號、縮進三重折磨
const html =
'<div>' +
' <p>Hello</p>' +
' <p>World</p>' +
'</div>';
// 模板字串雖好,但舊環境不支援,且無法直接貼入含反引號的內容
JS 函數的 toString() 會返回完整的函數聲明原始碼,包含註釋、縮進、換行——這就是天然的「多行原始字串容器」!
function _TEXT(fn) {
// 匹配 /* 內容 */ 或 // 內容\n
const match = fn.toString().match(/\/\*[\s\S]*?\*\/|\/\/.*/);
if (!match) return '';
// 移除註釋標記,保留純內容
return match[0]
.replace(/^\/\*\s*|\s*\*\/$/g, '') // /* ... */
.replace(/^\/\/\s*/gm, ''); // // ...
}
const RES_CODE = _TEXT(function(){/*
#include <iostream>
int main() {
std::cout << "Hello world" << std::endl;
return 0;
}
*/});
const RES_POEM = _TEXT(function(){/*
更吹落,星如雨。
寶馬雕車香滿路。
鳳箫聲動,玉壺光轉,一夜魚龍舞。
蛾兒雪柳黃金縷,
笑語盈盈暗香去。
眾裡尋他千百度,
蓦然回首,那人卻在燈火闌珊處。
*/});
const RES_XML = _TEXT(function(){/*
<projectDescription>
<name>Hello</name>
<comment></comment>
<buildSpec>
<buildCommand>
<name>com.adobe.flexbuilder.project.flexbuilder</name>
</buildCommand>
</buildSpec>
</projectDescription>
*/});
console.log(RES_CODE); // 完整保留縮進、換行、雙引號
console.log(RES_POEM); // 詩詞格式零損失
console.log(RES_XML); // XML 結構完美保持
function _RAW(fn, delimiter = 'CONTENT') {
const regex = new RegExp(`${delimiter}([\\s\\S]*?)${delimiter}`);
const match = fn.toString().match(regex);
return match ? match[1].trim() : '';
}
// 使用自定義分隔符,避免內容衝突
const sql = _RAW(function(){/*
@@@
SELECT u.name, p.title
FROM users u
JOIN posts p ON u.id = p.user_id
WHERE u.active = 1
@@@
*/}, '@@@');
| 限制 | 影響 | 解決方案 |
|---|---|---|
內容含 */ 會提前截斷 | 註釋結束標記衝突 | 使用 // 單行註釋模式或自定義分隔符 |
| 壓縮工具會刪除註釋 | 生產構建失效 | 配置 terser/uglify 保留特定註釋:comments: /^!/ |
箭頭函數 toString() 行為不一 | 可能返回編譯後代碼 | 堅持使用 function() {} 聲明式 |
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
模板字串 `...` | 原生、支援插值 | ES6+、反引號衝突 | 現代項目首選 |
import.meta.url + fetch | 外部檔案、快取友好 | 需網路、CORS 限制 | 大型模板、團隊協作 |
打包工具 raw-loader | 構建時內聯、無運行開銷 | 需 Webpack/Rollup | 工程化項目標配 |
| 本文技巧 | 零依賴、ES3 兼容、零轉義 | 註釋衝突、壓縮需配置 | 舊環境、快速原型、無建置流程 |
「函數註釋作字串容器」是 JS 動態特性的巧妙利用——將語法結構反向用作數據載體。雖然現代開發多有更好方案,但理解這類「非常規思維」能拓寬技術視野,在受限環境下成為破局利器。