前端更新後,使用者卻還是跑到舊版的行為,這種問題十之八九來自瀏覽器快取。最簡單的解法,是在檔案網址後面加上一個每次都不同的參數,讓瀏覽器以為這是一個新的資源。
<script language="javascript" type="text/javascript">
//防止 js 檔案快取下來,以後更新時不再需要用戶重新刪除 IE 檔案等操作。
var now=new Date();
var number = now.getYear().toString()+now.getMonth().toString()+now.getDate().toString()+now.getHours().toString()+now.getMinutes().toString()+now.getSeconds().toString();
document.write('<scr'+'ipt language="javascript" type="text/javascript" src="jb51net.js?"+number+""></scr'+'ipt>');
</script>
做法就是在固定網址後面接上一個每次都不同的日期數值,藉此讓網址不重複。瀏覽器無從比對快取,便會每次都即時向伺服器索取檔案,而不是從本機快取讀取。
程式碼中有個常被忽略的細節:'<scr'+'ipt' 之所以要拆成兩段字串拼接,是因為若直接寫出完整的 </script>,瀏覽器的 HTML 解析器會在執行到這段 JavaScript 之前就提前結束目前的 script 區塊,導致語法錯誤。拆開就避開了這個陷阱。
這個技巧特別適合動態驗證碼等需要每次都重新載入的情境。
本站實際應用實例:https://www.jb51.net/tools/files.shtml
以 document.write 動態寫入 script 標籤,在今天已經不建議使用。document.write 會阻塞解析、無法在非同步情境下使用,而且在頁面載入完成後呼叫會直接清空整個文件。以下是幾種更好的替代方案:
1. 交由伺服器設定快取標頭。這才是根本解法。在 HTML 中由後端輸出帶版本號的檔名(例如 app.v20240115.js),並在伺服器為靜態資源設定 Cache-Control 與 ETag。版本號變了網址就變,使用者自然會取到新檔;版本沒變時則可以長期快取,兩全其美。
2. 使用打包工具的內容雜湊。Webpack、Vite、Rollup 等工具會依檔案內容產生雜湊並附加到檔名,內容不動雜湊就不動,這比時間戳精準得多——時間戳會讓「內容完全沒改」的檔案也被重新下載,浪費頻寬。
3. 若只需在開發期強制更新。直接開啟開發者工具的「Disable cache」選項,或在重新整理時按住 Ctrl/Cmd + Shift + R 強制略過快取,不必改動程式碼。
另外要提醒,若把時間戳串接usercontent的 URL 上,可能會讓某些 CDN 或快取代理無法正常發揮作用,正式環境請優先採用檔名版本化的方式。