document.lastModified 會回傳目前文件的「最後修改時間」,字串形式。它讀的是伺服器送來的 Last-Modified 回應標頭。
<!DOCTYPE html> <html> <body> This document was last modified on: <script> document.write(document.lastModified); </script> </body> </html>
執行結果(格式會依瀏覽器與地區設定而異):
This document was last modified on: 04/03/2015 02:42:22
這是使用這個屬性最該注意的地方:回傳的日期字串格式沒有統一標準。同一個時間點,不同瀏覽器、不同語言版本的作業系統,可能顯示成 04/03/2015、2015/4/3、4/3/2015 上午 02:42:22 等樣子。直接拿去做字串比對或解析,一定會出問題。
若需要可比較的數值,請自行轉成時間戳,並先判斷是否為有效日期:
function getLastModified() {
var raw = document.lastModified;
if (!raw) return null;
var d = new Date(raw);
if (isNaN(d.getTime())) return null; // 部分瀏覽器在無資料時回傳 "01/01/1970" 或空字串
return d.getTime();
}
更可靠的做法是直接讀 HTTP 標頭。若你的站有後端,讓它回報檔案的 mtime;用 fetch 的話可以這樣:
fetch(location.href, { method: "HEAD", cache: "no-store" })
.then(function (res) {
var lm = res.headers.get("Last-Modified");
console.log(lm ? new Date(lm) : "伺服器未提供此標頭");
});
最常見的用法是「本站資料最後更新於 …」這類提示,讓讀者判斷內容新舊。實作時建議把時間格式化為 ISO 8601(toISOString())再依需求轉成本地格式,同時用 <time datetime="..."> 標籤標記,對 SEO 與無障礙都更友善。
限制方面:靜態檔若部署在 CDN 上,回傳的可能是 CDN 節點產生該副本的時間,而不是原作者修改的時間。動態產生的頁面(PHP、Node 輸出)則常常完全沒有這個標頭,此時 document.lastModified 會得到一個無意義的預設值。所以別把它當成「內容準確性」的依據,頂多當作粗略參考。