DIV CSS 佈局教程網

JS 讀寫本地 JSON 文件的兩種思路與現代替代方案
編輯:JavaScript綜合知識     

早期做純前端小工具時,常希望能把數據存到本地文件裡。這裡展示一種基於 ActiveX 的實現方式,同時也要說明它在今天的適用邊界。

一、原始實現代碼

// 保存數據到 json 文件
function funSave() {
    var id   = $('#testText1')[0].value;
    var name = $('#testText2')[0].value;

    var str = "{MyData:[{id:'" + id + "',name:'" + name + "'}]}";

    var fso, tf;
    try {
        fso = new ActiveXObject("Scripting.FileSystemObject");
        tf  = fso.CreateTextFile("F:\\BaiduYun\\MyHtmlDB_USER.json", true);
        tf.WriteLine(str);
    } catch(err) {
        // 處理異常
    } finally {
        tf.Close();
    }
}

// 讀取並解析
function funSearch() {
    var fso, ts, s;
    var ForReading = 1;

    try {
        fso = new ActiveXObject("Scripting.FileSystemObject");
        ts  = fso.OpenTextFile("F:\\BaiduYun\\MyHtmlDB_USER.json", ForReading);
        s   = ts.ReadLine();

        var json = eval('(' + s + ')');
        alert(json.MyData[0].id);
    } catch(err) {
        // 處理異常
    } finally {
        ts.Close();
    }
}

二、這套代碼的前提與風險

它只在特定環境下可用。ActiveXObject 是 IE 專屬技術,且需要:

  • 使用 Internet Explorer 瀏覽器
  • 打開「允許 ActiveX 初始化腳本」的內存設置
  • 頁面處於受信任站點區域
  • 路徑寫死為絕對路徑,換機器就失效

換句話說,這段代碼離開了作者本機幾乎無法運行,不具備任何通用性。

拼接字符串構造 JSON 是錯誤做法。"{id:'" + id + "'..." 這種寫法有兩個問題:一是如果用戶輸入包含單引號、雙引號或換行,生成的字符串直接就是非法 JSON;二是存在注入風險。正確做法是讓標準庫負責序列化。

eval() 必須避免。用 eval 解析字符串等於執行任意代碼,一旦文件內容被篡改就是安全漏洞。請改用 JSON.parse()。

finally 裡直接 tf.Close() 不安全。如果 CreateTextFile 本身就失敗了,tf 是 undefined,finally 裡再調 Close() 會拋出二次異常,把原始錯誤掩蓋掉。應該加一層判斷。

三、現代瀏覽器的正確做法

瀏覽器基於安全沙箱設計,不允許網頁腳本隨意讀寫本地任意路徑。這不是缺陷,而是必要的安全邊界。今天有三種正規方案:

方案一:localStorage(最簡單)

// 寫入
localStorage.setItem('userData', JSON.stringify({
    MyData: [{ id: '1', name: '小明' }]
}));

// 讀取
const raw = localStorage.getItem('userData');
const data = raw ? JSON.parse(raw) : null;

// 刪除
localStorage.removeItem('userData');

適合存放用戶偏好、草稿、購物車這類非關鍵數據。容量通常為 5MB 左右,且數據綁定在瀏覽器上,換設備就没了。

方案二:File System Access API(真正的文件讀寫)

// 選擇並讀取文件
async function openJsonFile() {
    const [handle] = await window.showOpenFilePicker({
        types: [{ description: 'JSON', accept: { 'application/json': ['.json'] } }]
    });
    const file = await handle.getFile();
    return JSON.parse(await file.text());
}

// 保存到文件
async function saveJsonFile(obj) {
    const handle = await window.showSaveFilePicker({
        suggestedName: 'data.json',
        types: [{ description: 'JSON', accept: { 'application/json': ['.json'] } }]
    });
    const writable = await handle.createWritable();
    await writable.write(JSON.stringify(obj, null, 2));
    await writable.close();
}

這才是現代瀏覽器提供的正規文件訪問方式,需要 HTTPS 環境與用戶顯式授權,Chrome、Edge 支持良好。

方案三:Blob 下載(兼容性最好)

function downloadJson(obj, filename = 'data.json') {
    const blob = new Blob(
        [JSON.stringify(obj, null, 2)],
        { type: 'application/json' }
    );
    const url = URL.createObjectURL(blob);
    const a = Object.assign(document.createElement('a'), {
        href: url, download: filename
    });
    a.click();
    URL.revokeObjectURL(url);      // 記得釋放
}

觸發瀏覽器下載到用戶的默認下載目錄,幾乎所有現代瀏覽器都支持。

四、如果確實需要寫入服務器

那就不該由前端直接操作文件系統,而應該通過後端接口:

await fetch('/api/users', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ MyData: [{ id, name }] })
});

讓服務端決定存到哪裡、如何做權限校驗與數據備份。前端只負責發請求,職責清晰,也更安全。

五、總結

本文的原始代碼在技術史上有其位置,但今天已無實用價值。核心要點是:不要拼接 JSON 字符串、不要用 eval 解析、不要指望網頁能隨意操作本地文件。牢記這三條,就能避開這一領域絕大多數的坑。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved