位置:assign() 方法
assign()
是 Location
接口的方法,用于使窗口加载并显示指定 URL 的文档。导航完成后,用户可以通过按“后退”按钮返回调用 Location.assign()
的页面。
语法
js
assign(url)
参数
url
-
包含要导航到的页面 URL 的字符串;例如,绝对 URL(如
https://mdn.org.cn/en-US/docs/Web/API/Location/reload
)或相对 URL(如/Web
(仅路径,用于导航到同一来源的另一个文档)或#specifications
(仅片段字符串,用于导航到同一页面的某个部分)等。
异常
SecurityError
DOMException
-
如果调用该方法的脚本的 来源 与最初由
Location
对象描述的页面的 同源策略 不一致,则会抛出此异常,主要是在脚本托管在不同的域上时。如果过于频繁地调用,浏览器也会限制导航并可能抛出此错误、生成警告或忽略调用。 SyntaxError
DOMException
-
如果提供的
url
参数不是有效的 URL,则会抛出此异常。
返回值
无 (undefined
).
示例
js
// Navigate to the Location.reload article
window.location.assign(
"https://mdn.org.cn/en-US/docs/Web/API/Location/reload",
);
// Then navigate to its Specifications section
window.location.assign("#specifications");
// Eventually navigate to https://mdn.org.cn/en-US/docs/Web
window.location.assign("/Web");
规范
规范 |
---|
HTML 标准 # dom-location-assign-dev |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
另请参阅
- 它所属的
Location
接口。 - 类似方法:
Location.replace()
和Location.reload()
。