HTML5 的離線緩存機制讓瀏覽器能把指定資源存在本機,即使沒有網路連線也能開啟頁面。要啟用這個功能,伺服器端與頁面端都需要做一些設定。
緩存清單檔必須以正確的 MIME 類型送出,否則瀏覽器不會認。以 Tomcat 為例,開啟 Tomcat 6.0/conf/web.xml,在檔尾加入:
<mime-mapping>
<extension>manifest</extension>
<mime-type>text/cache-manifest</mime-type>
</mime-mapping>
這裡有個容易出錯的細節:extension 的值決定了我們後續建立的清單檔副檔名必須是 .manifest,兩者要對得起來。若使用其他伺服器(如 Nginx、Apache、IIS),同樣需要手動加上對應的 MIME 設定。
<!DOCTYPE html>
<html manifest="/cache.manifest">
<body>
...
</body>
</html>
manifest 屬性的值指向伺服器上的清單檔路徑。要注意整個網站中只有「被快取的那個入口頁面」需要這個屬性,其他頁面不會因為加了它就一起被納入管理。
CACHE MANIFEST
index.html
time.js
time.css
FALLBACK:
server-time.js fallback-server-time.js
NETWORK:
*
這個檔由三個區段組成,中間各空一行分隔:
* 是萬用字元,代表其餘所有請求清單檔中通常以註解寫入版本標記:
# version 9
瀏覽器的判斷邏輯是「清單檔本身有沒有變」。只要檔案內容有任何差異(包含只改一行註解),就會觸發重新下載並更新快取。因此每次修改了快取資源,就要順手把版本號往上改,這是最簡單可靠的更新訊號。
這個機制(正式名稱是 Application Cache)在標準制定過程中因為設計缺陷過多,已被 WHATWG 從規範中移除,MDN 也明確標示為不建議使用。常見的問題包括:
如果目標是讓 Web 應用支援離線使用,現在的正確做法是 Service Worker 搭配 Cache Storage API。Service Worker 以 JavaScript 撰寫攔截邏輯,可以精確決定哪些請求走快取、哪些走網路、離線時如何降級,除錯也能直接在開發者工具中觀察。上面這套 manifest 寫法今天主要存在於維護舊專案的情境中。