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_ERRORDOMException 异常。当调用该方法的脚本所属的源与拥有 Location 对象所属源不同时,通常情况会发生这种异常,此时通常该脚本是存在不同的域下。

如果 URL 无效,浏览器也会抛出 SYNTAX_ERROR 类型的 DOMException 异常。

语法

object.replace(url);

参数

url

DOMString 类型,指定所导航到的页面的 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

参见