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.org.cn/en-US/docs/Web/API/Location.reload",
);

规范

规范
HTML # dom-location-replace-dev

浏览器兼容性

另见

它所属的 Location 接口。
类似方法：Location.assign() 和 Location.reload()。

帮助改进 MDN

了解如何贡献

此页面最后修改于 2024年10月26日，由 MDN 贡献者。

在 GitHub 上查看此页面 • 报告此内容的错误