History：replaceState() 方法

语法

replaceState(state, unused)
replaceState(state, unused, url)

参数

state

一个与传递给 replaceState() 方法的历史记录条目相关联的对象。状态对象可以是 null。

unused

该参数由于历史原因而存在，不能省略；传递空字符串是传统的做法，也可以安全地应对未来对该方法的变更。

url 可选

历史记录条目的 URL。新的 URL 跟当前的 URL 必须同源；否则 replaceState() 方法将抛出异常。

返回值

无（undefined）。

异常

SecurityError DOMException

如果关联的文档没有完全激活，或者提供的 url 参数不是有效的 URL，则抛出该异常。

DataCloneError DOMException

如果提供的 state 参数不可序列化，则抛出该异常。

示例

假设 https://www.mozilla.org/foo.html 执行了以下 JavaScript 代码：

const stateObj = { foo: "bar" };
history.pushState(stateObj, "", "bar.html");

在下一个页面，你可以使用 history.state 来访问刚刚添加的 stateObj。

上面这两行的解释可以在使用历史记录 API 一文中找到。然后假设 https://www.mozilla.org/bar.html 执行了下面的 JavaScript 代码：

history.replaceState(stateObj, "", "bar2.html");

这会让 URL 栏显示 https://www.mozilla.org/bar2.html，但是不会加载 bar2.html 页面，甚至不会检查 bar2.html 是否存在。

假设用户跳转到 https://www.microsoft.com，然后点击返回按钮。这时，URL 栏将会显示 https://www.mozilla.org/bar2.html。如果用户此时再次点击返回按钮，URL 栏将会显示 https://www.mozilla.org/foo.html 页面，而完全绕过了 bar.html 页面。

规范

浏览器兼容性