Location: assign() 方法

语法

assign(url)

参数

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）。

示例

// 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");

规范

浏览器兼容性

另见

• 它所属的 Location 接口。
• 类似方法：Location.replace() 和 Location.reload()。