location.reload()

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.reload() 方法用来刷新当前页面,就像刷新按钮一样。

该方法在跨域调用(执行该方法的脚本文件的域和 Location 对象所在页面的域不同)时,将会抛出 SECURITY_ERROR DOMException 异常。有关更多信息,请参阅浏览器的同源策略

语法

js
location.reload();

location.reload() 没有参数

Firefox 对于该方法支持一个非标准的 forceGet boolean 参数 ,当值为 true 时,将强制 Firefox 从服务器加载页面资源。但是在其他浏览器中任何参数都是无效的,location.reload() 执行时将会忽略它们并且不会有任何效果。

不过你可能会看到在现有的代码中写入 location.reload(true) 并假装硬性重新加载在所有浏览器中均生效的使用方式。在 GitHub 中搜索 "location.reload(true)" 将会得到 成千上万个结果。所以现在有大量的现有代码中包含它。

由于一些历史的原因,网景浏览器的一些版本添加了对它的支持,显然被继承到了 Firefox 中。并且一度被 W3C Web APIs 工作组作为一个提案来考虑添加到 location.reload() 中。但是它从未实际实现过。

因此 boolean 参数当前不符合 location.reload() 的规范。— 实际上它从未成为 location.reload() 的规范。

规范

Specification
HTML Standard
# dom-location-reload-dev

浏览器兼容性

BCD tables only load in the browser

相关链接