在 HTML5 之前,網頁大多需要連線才能正常存取。對桌上型電腦而言,這通常不是大問題;但到了行動裝置時代,使用者可能會在車廂、隧道、地下空間或訊號不穩的環境中開啟網頁。如果頁面完全依賴網路,就可能出現空白、載入失敗或操作不順的情況。
為了改善這個問題,HTML5 引入了 cache manifest 機制,讓開發者可以指定哪些資源需要被瀏覽器快取,从而在沒有網路或網路不穩時,仍能提供基本的離線瀏覽體驗。
manifest 是一個文字檔案,通常用來列出需要快取的資源。瀏覽器在支援此機制的情況下,會依照 manifest 檔案中的規則,將指定檔案儲存在本機。當使用者再次造訪該頁面時,即使沒有網路,也可以讀取已快取的內容。
當頁面第一次正確設定 manifest 後,瀏覽器會在後續訪問時檢查 manifest 是否有變動。如果有變動,就會更新快取內容;如果沒有變動,則直接使用本機快取資源。這個流程是 manifest 離線體驗的核心。
大部分現代瀏覽器都支援應用程式快取機制,但不同版本的支援程度與細節可能有所差異。部分舊版 Internet Explorer 對此功能的支援較為有限,因此在實際專案中仍需確認目標裝置與瀏覽器環境。
HTML5 在 html 標籤上提供了 manifest 屬性,用來指定目前頁面要使用的 manifest 檔案。常見做法是建立一個與頁面同名的 manifest 檔案,例如 index.manifest,然後在 HTML 中引用它。
<html lang="en" manifest="index.manifest">
<head>
<meta charset="UTF-8" />
<title>Offline Page</title>
</head>
<body>
<p>Hello Manifest</p>
</body>
</html>
一個典型的 manifest 檔案通常以 CACHE MANIFEST 開頭,後面可以包含 CACHE、NETWORK、FALLBACK 等區段。其中 CACHE 用來列出需要快取的檔案,NETWORK 用來指定需要網路連線的資源,FALLBACK 則用來設定替代資源。
CACHE MANIFEST
# version 1.0
CACHE:
test.css
test.js
NETWORK:
*
FALLBACK:
/ /offline.html
第一行 CACHE MANIFEST 是固定格式,必須放在最前面。以 # 符號開頭的是註解,實務上常會在第二行寫入版本號、時間戳或其他識別資訊,用來觸發快取更新。
CACHE 區段列出需要被儲存到本機的檔案,可以是相對路徑或絕對路徑。這些檔案會成為離線時的主要資源來源。
CACHE:
a.css
https://example.com/a.css
NETWORK 區段用來指定哪些資源不應走快取,而必須透過網路取得。例如登入 API、即時資料或需要最新狀態的頁面,就可以放在這裡。
NETWORK:
login.asp
也可以使用星號表示其餘資源都需要網路連線:
NETWORK:
*
FALLBACK 區段的功能,是在某個資源無法取得時,改用另一個檔案作為替代。例如當網路中斷,原本要載入的頁面無法取得時,可以顯示離線提示頁或錯誤頁。
FALLBACK:
/html5/ /404.html
也可以使用更廣泛的規則,讓符合條件的資源都導向同一個替代頁面。
FALLBACK:
*.html /404.html
更新 manifest 快取常見有三種方式:
window.applicationCache.update();
如果 manifest 中有新增或移除檔案,通常也會觸發更新。但若是只修改既有檔案內容,而沒有改變 manifest 清單,最簡單可靠的方式仍是更新 manifest 中的版本註解或時間戳。
以下是一個簡單的 manifest 引用範例。頁面載入後,瀏覽器會嘗試快取指定資源,並將 manifest 的運作資訊顯示在開發者工具中。
<html manifest="test.manifest">
<head>
<link href="test.css" rel="stylesheet" />
<script src="test.js"></script>
</head>
<body>
<div>Manifest Demo</div>
</body>
</html>
從開發者工具中可以觀察到,除了 manifest 中列出的檔案外,引用 manifest 的頁面本身也可能被快取。這是 manifest 機制的一部分,使用時需要特別注意。
如果某個 CSS 檔案不存在,可以透過 FALLBACK 讓瀏覽器改用另一個檔案。
CACHE MANIFEST
# test.manifest
FALLBACK:
/x.css /test.css
在這個例子中,由於 x.css 不存在,因此快取時會使用 test.css 作為替代資源。
第一,不同瀏覽器對快取容量的限制可能不同,部分環境可能會限制每個站點可用的空間。
第二,如果 manifest 檔案本身或其中列出的某個檔案無法下載,整個更新流程可能會失敗,瀏覽器會繼續使用舊快取。
第三,引用 manifest 的頁面與 manifest 檔案必須同源,也就是要在同一個網域下。
第四,FALLBACK 中指定的資源也必須與 manifest 檔案同源。
第五,當資源被快取後,即使其他頁面沒有設定 manifest,只要請求的是同一個路徑,也可能直接從快取中取得內容。
第六,部分瀏覽器在使用 manifest 時可能會顯示警告,例如提醒開發者此頁面將使用離線快取。這類提示在部署前應納入測試。
manifest 檔案中的 CACHE 區段不支援通配符,必須手動列出檔案。當專案檔案數量變多時,逐一手動維護會變得繁瑣。此時可以借助 grunt-manifest 這類自動化工具來產生 manifest 檔案。
grunt-manifest 依賴 grunt,而 grunt 是一套前端自動化建置工具。若專案已經使用 grunt,就可以透過以下指令安裝:
npm install grunt-manifest --save-dev
在 grunt 設定檔中載入:
grunt.loadNpmTasks('grunt-manifest');
常見設定概念如下:
grunt.initConfig({
manifest: {
generate: {
options: {
basePath: "../",
cache: ["js/app.js", "css/style.css"],
network: ["https://*", "https://*"],
fallback: ["/ /offline.html"],
exclude: ["js/jquery.min.js"],
preferOnline: true,
verbose: true,
timestamp: true
},
src: [
"some_files/*.html",
"js/*.min.js",
"css/*.css"
],
dest: "index.manifest"
}
}
});
其中,basePath 用來設定輸出路徑的根目錄;cache 用來加入需要快取的檔案;network 用來加入需要網路存取的資源;fallback 用來設定替代資源;exclude 用來排除不需要進入 cache 的檔案;timestamp 則可自動加入時間戳,方便更新。
Manifest 離線快取讓網頁具備基本的離線能力,特別適合閱讀型內容、靜態頁面或需要降低網路依賴的應用。不過,這套機制的更新邏輯與瀏覽器行為較為特殊,部署前必須充分測試。若只是單純想讓 Web 應用更像原生應用,manifest 可以提供一個入門級的實作方向。