Location.replace()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Location.replace()
方法以给定的 URL 来替换当前的资源。与 assign()
方法 不同的是,调用 replace()
方法后,当前页面不会保存到会话历史中(session History
),这样,用户点击回退按钮时,将不会再跳转到该页面。
因违反安全规则导致的赋值失败,浏览器将会抛出类型为 SECURITY_ERROR
的 DOMException
异常。当调用该方法的脚本所属的源与拥有 Location
对象所属源不同时,通常情况会发生这种异常,此时通常该脚本是存在不同的域下。
如果 URL 无效,浏览器也会抛出 SYNTAX_ERROR
类型的 DOMException
异常。
语法
object.replace(url);
参数
示例
js
// Navigate to the Location.reload article by replacing this page
window.location.replace(
"https://developer.mozilla.org/zh-CN/docs/Web/API/Location/reload",
);
规范
Specification |
---|
HTML Standard # dom-location-replace-dev |
浏览器兼容性
BCD tables only load in the browser
参见
Location
对象。- 类似方法:
Location.assign()
和Location.reload()
。