Window：hashchange 事件

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

當 URL 的片段識別符號（URL 中以 # 符號開頭的部分）發生變化時，會觸發 hashchange 事件。

使用 history.pushState() 或 history.replaceState() 修改雜湊值時，不會觸發此事件。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱，或設定事件處理程式屬性。

addEventListener("hashchange", (event) => { })

onhashchange = (event) => { }

事件型別

一個 HashChangeEvent。繼承自 Event。

事件屬性

HashChangeEvent.newURL 只讀: 一個字串，表示視窗正在導航到的新 URL。
HashChangeEvent.oldURL 只讀: 一個字串，表示視窗從中導航到的前一個 URL。

事件處理程式別名

除了 Window 介面之外，以下目標也可用事件處理屬性 onhashchange：

示例

您可以在 addEventListener 方法中使用 hashchange 事件

window.addEventListener("hashchange", () => {
  console.log("The hash has changed!");
});

或者使用 onhashchange 事件處理屬性

function locationHashChanged() {
  if (location.hash === "#cool-feature") {
    console.log("You're visiting a cool feature!");
  }
}

window.onhashchange = locationHashChanged;

規範

規範
HTML # event-hashchange
HTML # handler-window-onhashchange

瀏覽器相容性

另見

popstate 事件

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年9月18日⁩，作者為 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的某個問題