瀏覽器的歷史紀錄涉及使用者的隱私與瀏覽習慣,出於安全考量,規範對 History 物件施加了嚴格限制。開發者既讀不到完整的網址清單,也無法任意改寫歷史條目,最終能操作的只剩下一小把屬性與方法。
history.length 會回傳一個數字,代表目前這段歷史中可供「上一頁」與「下一頁」移動的網址總數。要注意的是,它統計的是整段瀏覽器工作階段累積下來的項目,並不等於「你這個網站被造訪過幾次」。也正因如此,這個數字拿來判斷使用者的完整瀏覽路徑並不可靠,通常只用來確認是否還有可回退的空間。
history.back() 的效果與點擊瀏覽器工具列上的後退鍵完全一致,會把使用者帶回上一筆紀錄。若已經位於歷史起點,呼叫它不會有任何反應,也不會拋出錯誤。
history.forward() 則相反,會往歷史的下一筆前進。這個方法有個前提:只有在使用者是「往回走」之後才會有可前進的紀錄。如果使用者是從外部連結直接進到目前這一頁,前進按鈕本身就是灰色的,呼叫 forward() 同樣不會有效果。
當你需要的不是單純前後一格,而是跨越多筆紀錄時,就可以用 go():
history.go(x);
參數 x 的意義依正負而異:
x < 0:往後退 x 筆,例如 history.go(-3) 相當於連按三次後退鍵。x > 0:往前往 x 筆。x == 0:重新載入目前頁面,效果等同 location.reload()。實務上最常見的用法就是 history.go(0),很多老舊專案會用它做「重新整理」按鈕。不過若你的目的只是刷新頁面,直接呼叫 location.reload() 語意更清楚,也更容易被後續維護者理解。
History 物件的設計哲學是「能操縱流程,但不能窺探內容」。你可以代替使用者按下後退、前進,卻無法得知他上一頁看的是什麼。近年來隨著單頁應用(SPA)普及,真正的路由管理多半交由 History API 的 pushState 與 replaceState 處理,而上面這些傳統方法則多用於處理表單中途返回、多步驟流程的返回節點等情境。理解它們的定位,比背誦語法更重要。