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 document.location.replace('https://developer.mozilla.org/en-US/docs/Web/API/Location.reload');
标准
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard Location.replace() |
Living Standard | No change from HTML5. |
HTML5 Location.replace() |
Recommendation | Initial definition. |
浏览器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
参见
Location
对象。- 类似方法:
Location.assign()
和Location.reload()
。