萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 操作本地檔案系統:ActiveXObject FileSystemObject 完整教學(僅限 IE/HTA/Node.js 原生模組替代方案)

JS 操作本地檔案:ActiveXObject 方案詳解與現代替代技術對比

⚠️ 重要前提:ActiveXObject 僅在 Internet Explorer (含 IE 模式)、HTA (HTML Application)、舊版 Electron (nodeIntegration) 等特定環境可用。現代瀏覽器(Chrome、Firefox、Edge、Safari)完全不支援,基於安全沙箱模型禁止網頁直接存取本地檔案系統。本文為維護舊專案/內網系統開發者提供完整參考,並介紹現代 Web 標準替代方案。

一、ActiveXObject 基礎語法

var obj = new ActiveXObject(servername.typename[, location]);
// servername: 提供物件的應用程式 (如 "Scripting.FileSystemObject")
// typename: 物件類別 (如 "File", "Folder", "TextStream")
// location: 遠端伺服器名稱 (極少用)

二、核心物件:Scripting.FileSystemObject (FSO)

FSO 是操作檔案系統的入口,提供建立、讀寫、複製、移動、刪除、屬性查詢等完整功能。

1. 建立 FSO 實例

var fso = new ActiveXObject("Scripting.FileSystemObject");

2. 操作資料夾 (Folder)

// 取得資料夾物件
var folder = fso.GetFolder("D:\\data");

// 屬性
folder.Name;           // 資料夾名稱
folder.Path;           // 完整路徑
folder.Size;           // 大小 (bytes)
folder.DateCreated;    // 建立時間
folder.DateLastModified;
folder.Files;          // 檔案集合 (Files)
folder.SubFolders;     // 子資料夾集合 (Folders)
folder.IsRootFolder;   // 是否為根目錄

// 方法
fso.CreateFolder("D:\\new_folder");
fso.DeleteFolder("D\\old_folder"); // true=強制刪除唯讀
fso.MoveFolder("D:\\src", "D:\\dest");
fso.CopyFolder("D:\\src", "D:\\dest", true); // true=覆寫

// 遍歷檔案
var files = new Enumerator(folder.Files);
for (; !files.atEnd(); files.moveNext()) {
    var file = files.item();
    console.log(file.Name, file.Size, file.DateLastModified);
}

3. 操作檔案 (File)

var file = fso.GetFile("D:\\test.txt");

// 屬性
file.Name, file.Path, file.Size, file.Type, file.DateCreated, file.DateLastModified, file.DateLastAccessed;
file.Attributes; // 唯讀/隱藏/系統/封存 位元組合

// 讀取文字檔
var ts = fso.OpenTextFile(file.Path, 1 /* ForReading */, false /* create */, 0 /* ASCII */);
// 或
var ts = file.OpenAsTextStream(1, 0);
var content = "";
while (!ts.AtEndOfStream) {
    content += ts.ReadLine() + "\n";
}
ts.Close();

// 寫入文字檔 (覆寫)
var ts = fso.CreateTextFile("D\\output.txt", true /* overwrite */, true /* Unicode */);
ts.WriteLine("第一行");
ts.Write("不換行");
ts.Close();

// 追加模式
var ts = fso.OpenTextFile("D\\log.txt", 8 /* ForAppending */, true, 0);
ts.WriteLine(new Date() + " - Log entry");
ts.Close();

// 複製/移動/刪除
fso.CopyFile("D:\\src.txt", "D:\\dest.txt", true);
fso.MoveFile("D:\\src.txt", "D:\\dest.txt");
fso.DeleteFile("D:\\temp.txt");

4. 操作磁碟機

var drive = fso.GetDrive("C:");
drive.TotalSize;      // 總容量 (bytes)
drive.FreeSpace;      // 可用空間
drive.DriveLetter;    // "C"
drive.DriveType;      // 0=Unknown, 1=Removable, 2=Fixed, 3=Network, 4=CD-ROM, 5=RAM
drive.FileSystem;     // "NTFS", "FAT32"...
drive.IsReady;        // 是否就緒
drive.VolumeName;     // 磁碟標籤

三、完整範例:遍歷資料夾讀取所有文字檔內容

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>FSO Demo (IE Only)</title></head><body>
<input type="button" value="遍歷 D:\\test 讀取所有 .txt" onclick="readFolder()">
<input type="button" value="寫入 Excel 測試" onclick="writeExcel()">
<pre id="output" style="background:#f5f5f5;padding:10px;max-height:400px;overflow:auto"></pre>

<script>
function log(msg) { document.getElementById('output').textContent += msg + '\n'; }

function readFolder() {
    var fso = new ActiveXObject("Scripting.FileSystemObject");
    var folder = fso.GetFolder("D:\\test");
    var files = new Enumerator(folder.Files);
    for (; !files.atEnd(); files.moveNext()) {
        var file = files.item();
        if (file.Name.toLowerCase().endsWith(".txt")) {
            var ts = fso.OpenTextFile(file.Path, 1);
            var content = ts.ReadAll();
            ts.Close();
            log("=== " + file.Name + " ===");
            log(content);
        }
    }
}

function writeExcel() {
    try {
        var xl = new ActiveXObject("Excel.Application");
        var wb = xl.Workbooks.Add();
        var ws = wb.ActiveSheet;
        ws.Cells(1, 1).Value = "Hello from JS + ActiveX!";
        wb.SaveAs("D:\\TestOutput.xls");
        wb.Close(false);
        xl.Quit();
        log("Excel 寫入完成: D:\\TestOutput.xls");
    } catch (e) {
        log("Excel 自動化失敗: " + e.message + " (需安裝 Office 並允許 ActiveX)");
    }
}
</script>
</body></html>

四、現代 Web 替代方案(標準、跨平台、安全)

需求現代標準 API支援環境備註
用戶選擇檔案讀取<input type="file"> + FileReader所有現代瀏覽器需用戶主動點選,無法自動掃描資料夾
資料夾選擇/批量讀取File System Access API (window.showDirectoryPicker())Chrome 86+, Edge 86+ (需 HTTPS/用戶手勢)可讀寫用戶授權的資料夾,強大但需權限
拖曳檔案/資料夾Drag and Drop API (DataTransfer.files)所有現代瀏覽器支援資料夾拖入 (webkitGetAsEntry)
本地儲存大量結構化資料IndexedDB所有現代瀏覽器非檔案系統,但可儲存 Blob/檔案
Node.js / Electron 後端fs, path, fs.promisesNode.js 環境完整檔案系統權限,適合桌面應用/後端服務
PWA 離線檔案快取Cache API + Service Worker支援 SW 的瀏覽器快取靜態資源,非使用者檔案

五、遷移建議

  1. 內網 IE 專案維護:繼續使用 ActiveXObject,但規劃遷移路線圖。
  2. 新專案/現代化:採用 File System Access API (Chrome/Edge) + input[type=file] 降級方案。
  3. 桌面應用需求:改用 Electron + Node.js fs 模組,擁有完整檔案系統權限。
  4. 伺服器端檔案處理:前端上傳 → 後端 Node.js/Java/Python 處理 → 回傳結果,符合安全架構。

六、安全性警示

  • ActiveXObject 擁有完整本地檔案系統權限,惡意腳本可刪除系統檔案、竊取敏感資料、植入病毒。
  • IE 預設禁止網頁區域執行 ActiveX,需將站點加入「信任站點」並降低安全性等級,極不推薦對外公開網站使用。
  • HTA (.hta) 檔案以應用程式身份執行,擁有高權限,僅限內部分發、簽名部署。

理解歷史技術邊界與現代標準演進,才能在維護舊系統與建構新架構間做出正確技術決策。

copyright © 萬盛學電腦網 all rights reserved