Location：replace() 方法

Baseline 已廣泛支援

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

Location 介面的 replace() 方法用提供的 URL 替換當前資源。與 assign() 方法的區別在於，使用 replace() 後，當前頁面不會被儲存在會話 History 中，這意味著使用者將無法使用“後退”按鈕導航回它。請勿與 String 方法 String.prototype.replace() 混淆。

語法

replace(url)

引數

url: 一個字串或任何其他具有字串轉換器的物件，例如一個 URL 物件，其中包含要導航到的頁面的 URL。

異常

SecurityError DOMException: 瀏覽器會限制導航的頻率，如果呼叫過於頻繁，可能會丟擲此錯誤、生成警告或忽略該呼叫。
SyntaxError DOMException: 如果提供的 url 引數不是有效 URL，則丟擲此錯誤。

返回值

無（undefined）。

示例

// Navigate to the Location.reload article by replacing this page
window.location.replace(
  "https://mdn.club.tw/en-US/docs/Web/API/Location.reload",
);

規範

規範
HTML # dom-location-replace-dev

瀏覽器相容性

另見

它所屬的 Location 介面。
類似方法：Location.assign() 和 Location.reload()。

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2024年10月26日，由 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤