⚠️ 重要前提:ActiveXObject 僅在 Internet Explorer (含 IE 模式)、HTA (HTML Application)、舊版 Electron (nodeIntegration) 等特定環境可用。現代瀏覽器(Chrome、Firefox、Edge、Safari)完全不支援,基於安全沙箱模型禁止網頁直接存取本地檔案系統。本文為維護舊專案/內網系統開發者提供完整參考,並介紹現代 Web 標準替代方案。
var obj = new ActiveXObject(servername.typename[, location]);
// servername: 提供物件的應用程式 (如 "Scripting.FileSystemObject")
// typename: 物件類別 (如 "File", "Folder", "TextStream")
// location: 遠端伺服器名稱 (極少用)
FSO 是操作檔案系統的入口,提供建立、讀寫、複製、移動、刪除、屬性查詢等完整功能。
var fso = new ActiveXObject("Scripting.FileSystemObject");
// 取得資料夾物件
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);
}
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");
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>
| 需求 | 現代標準 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.promises | Node.js 環境 | 完整檔案系統權限,適合桌面應用/後端服務 |
| PWA 離線檔案快取 | Cache API + Service Worker | 支援 SW 的瀏覽器 | 快取靜態資源,非使用者檔案 |
File System Access API (Chrome/Edge) + input[type=file] 降級方案。fs 模組,擁有完整檔案系統權限。理解歷史技術邊界與現代標準演進,才能在維護舊系統與建構新架構間做出正確技術決策。