位置: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 的浏览器中加载。

另请参阅