Location.replace()
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()
。