本文 API 屬於 Windows Script Host (WSH) 環境(.js、.wsf 檔案雙擊或 cscript.exe / wscript.exe 執行),非瀏覽器 JavaScript。瀏覽器因安全沙箱無法直接存取本地檔案系統。
Scripting.FileSystemObjectconst fso = new ActiveXObject('Scripting.FileSystemObject');
function readFile(path, encoding = 'utf-8') {
const fso = new ActiveXObject('Scripting.FileSystemObject');
const file = fso.OpenTextFile(path, 1, false, encoding === 'unicode' ? -1 : 0); // 1=ForReading
const content = file.ReadAll();
file.Close();
return content;
}
function writeFile(path, content, append = false, encoding = 'utf-8') {
const fso = new ActiveXObject('Scripting.FileSystemObject');
// 2=ForWriting(覆寫), 8=ForAppending(附加)
const mode = append ? 8 : 2;
const file = fso.OpenTextFile(path, mode, true, encoding === 'unicode' ? -1 : 0); // true=create
file.Write(content);
file.Close();
}
function listFiles(folderPath, recursive = false) {
const fso = new ActiveXObject('Scripting.FileSystemObject');
const folder = fso.GetFolder(folderPath);
const result = {files: [], folders: []};
const enumFiles = new Enumerator(folder.Files);
for (; !enumFiles.atEnd(); enumFiles.moveNext()) {
result.files.push(enumFiles.item().Path);
}
if (recursive) {
const enumFolders = new Enumerator(folder.SubFolders);
for (; !enumFolders.atEnd(); enumFolders.moveNext()) {
const sub = enumFolders.item();
result.folders.push(sub.Path);
// 遞迴
const subResult = listFiles(sub.Path, true);
result.files.push(...subResult.files);
result.folders.push(...subResult.folders);
}
} else {
const enumFolders = new Enumerator(folder.SubFolders);
for (; !enumFolders.atEnd(); enumFolders.moveNext()) {
result.folders.push(enumFolders.item().Path);
}
}
return result;
}
function copyFile(src, dest, overwrite = true) {
const fso = new ActiveXObject('Scripting.FileSystemObject');
fso.CopyFile(src, dest, overwrite);
}
function moveFile(src, dest) {
const fso = new ActiveXObject('Scripting.FileSystemObject');
fso.MoveFile(src, dest);
}
function deleteFile(path) {
const fso = new ActiveXObject('Scripting.FileSystemObject');
if (fso.FileExists(path)) fso.DeleteFile(path);
}
function deleteFolder(path, force = true) {
const fso = new ActiveXObject('Scripting.FileSystemObject');
if (fso.FolderExists(path)) fso.DeleteFolder(path, force);
}
function getDriveInfo(driveLetter = 'C:') {
const fso = new ActiveXObject('Scripting.FileSystemObject');
const drv = fso.GetDrive(fso.GetDriveName(driveLetter));
return {
letter: drv.DriveLetter,
type: drv.DriveType, // 1=可移動, 2=固定, 3=網路, 4=光碟, 5=RAM
fileSystem: drv.FileSystem,
totalSize: drv.TotalSize,
freeSpace: drv.FreeSpace,
availableSpace: drv.AvailableSpace,
volumeName: drv.VolumeName,
serialNumber: drv.SerialNumber,
isReady: drv.IsReady,
shareName: drv.ShareName,
path: drv.Path,
rootFolder: drv.RootFolder
};
}
WSH 集合(Files、Folders、SubFolders)不支援 for...of,需用 Enumerator:
const enum = new Enumerator(collection);
for (; !enum.atEnd(); enum.moveNext()) {
const item = enum.item(); // 當前項目
// 處理 item
}
// backup.js
const src = 'D:\\Projects\\MyApp';
const dest = 'E:\\Backups\\MyApp_' + new Date().toISOString().slice(0,10).replace(/-/g,'');
const fso = new ActiveXObject('Scripting.FileSystemObject');
function copyFolderRecursive(srcPath, destPath) {
if (!fso.FolderExists(destPath)) fso.CreateFolder(destPath);
const srcFolder = fso.GetFolder(srcPath);
// 複製檔案
const eFiles = new Enumerator(srcFolder.Files);
for (; !eFiles.atEnd(); eFiles.moveNext()) {
const file = eFiles.item();
fso.CopyFile(file.Path, destPath + '\\' + file.Name, true);
}
// 遞迴子資料夾
const eFolders = new Enumerator(srcFolder.SubFolders);
for (; !eFolders.atEnd(); eFolders.moveNext()) {
const folder = eFolders.item();
copyFolderRecursive(folder.Path, destPath + '\\' + folder.Name);
}
}
try {
copyFolderRecursive(src, dest);
WScript.Echo('備份完成:' + dest);
} catch (e) {
WScript.Echo('錯誤:' + e.message);
WScript.Quit(1);
}
執行:cscript //nologo backup.js
僅在維護舊有 WSH 自動化腳本、HTA 應用、或純 Windows 內網環境才建議繼續使用本文技術。