HTML5 其中一項強大能力,是允許網頁應用程式向瀏覽器申請臨時或永久的儲存空間。透過 FileSystem API,開發者可以在用戶端進行資料儲存,甚至操作虛擬檔案與目錄。
這類檔案系統通常運行在沙盒環境中,不同網站之間無法互相存取彼此的資料,因此能兼顧使用便利與資料安全。
要使用 FileSystem API,首先必須向瀏覽器申請配額。若是永久儲存,瀏覽器可能會跳出確認提示,只有使用者同意後才會繼續執行。
實務上常會看到 requestFileSystem 與 webkitRequestFileSystem 等寫法,這是為了相容不同瀏覽器版本。呼叫時通常會指定儲存型態、容量大小、成功回呼與錯誤回呼。
如果每次載入頁面都重新申請空間,體驗並不理想。因此可先查詢目前網站的用量與配額。queryUsageAndQuota 這類 API 能回傳已使用空間與剩餘空間,開發者可依此判斷是否尚未初始化。
FileSystem 使用特殊的虛擬路徑與沙盒模式,一般無法直接用本機檔案路徑存取。常見做法是透過 filesystem 協定搭配網域與儲存型態,再由 resolveLocalFileSystemURL 取得檔案或目錄的 entry 物件。
取得目錄 entry 後,可呼叫 createReader 建立目錄讀取器,再用 readEntries 讀取其中的檔案與子目錄。若結果為空,可建立預設檔案;若有內容,則可逐一處理檔名與檔案內容。
FileSystem API 的瀏覽器支援情況差異較大,實際專案導入前應先確認目標環境。此外,永久儲存通常涉及使用者同意與配額管理,不適合當作唯一資料來源,重要資料仍應有伺服器端或雲端備份機制。