Location.replace()
Location
.replace()
方法以给定的URL来替换当前的资源。 与assign()
方法 不同的是,调用 replace()
方法后,当前页面不会保存到会话历史中(session History
),这样,用户点击回退按钮时,将不会再跳转到该页面。
因违反安全规则导致的赋值失败,浏览器将会抛出类型为 SECURITY_ERROR
的 DOMException
异常。当调用该方法的脚本所属的源与拥有 Location
对象所属源不同时,通常情况会发生这种异常,此时通常该脚本是存在不同的域下。
如果 URL 无效,浏览器也会抛出 SYNTAX_ERROR
类型的 DOMException
异常。
语法
object.replace(url);
参数
- url
-
DOMString
类型,指定所导航到的页面的 URL 地址。
示例
// Navigate to the Location.reload article by replacing this page
window.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location/reload');
标准
Specification | Status | Comment |
---|---|---|
HTML Living Standard Location.replace() |
Living Standard | No change from HTML5. |
HTML5 Location.replace() |
Recommendation | Initial definition. |
浏览器兼容性
BCD tables only load in the browser
参见
Location
对象。- 类似方法:
Location.assign()
和Location.reload()
。