View in EnglishAlways switch to English

Location

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

* Some parts of this feature may have varying levels of support.

Location 接口表示其链接到的对象的位置（URL）。所做的修改反映在与之相关的对象上。Document 和Window 接口都有这样一个链接的 Location，分别通过Document.location和Window.location 访问。

属性

Location 接口不继承任何属性，但是实现了那些来自URLUtils 的属性。

Location.href: 包含整个 URL 的一个DOMString
Location.protocol: 包含 URL 对应协议的一个DOMString，最后有一个":"。
Location.host: 包含了域名的一个DOMString，可能在该串最后带有一个":"并跟上 URL 的端口号。
Location.hostname: 包含 URL 域名的一个DOMString。
Location.port: 包含端口号的一个DOMString。
Location.pathname: 包含 URL 中路径部分的一个DOMString，开头有一个/。
Location.search: 包含 URL 参数的一个DOMString，开头有一个“?”。
Location.hash: 包含块标识符的DOMString，开头有一个#。
Location.username: 包含 URL 中域名前的用户名的一个DOMString。
Location.password: 包含 URL 域名前的密码的一个DOMString。
Location.origin只读: 包含页面来源的域名的标准形式DOMString。

方法

Location 没有继承任何方法，但实现了来自URLUtils的方法。

Location.assign(): 加载给定 URL 的内容资源到这个 Location 对象所关联的对象上。
Location.reload(): 重新加载来自当前 URL 的资源。他有一个特殊的可选参数，类型为Boolean，该参数为 true 时会导致该方法引发的刷新一定会从服务器上加载数据。如果是false或没有制定这个参数，浏览器可能从缓存当中加载页面。
Location.replace(): 用给定的 URL 替换掉当前的资源。与assign() 方法不同的是用replace()替换的新页面不会被保存在会话的历史History中，这意味着用户将不能用后退按钮转到该页面。
Location.toString(): 返回一个DOMString，包含整个 URL。它和读取URLUtils.href的效果相同。但是用它是不能够修改 Location 的值的。

例子

// Create anchor element and use href property for the purpose of this example// A more correct alternative is to browse to the URL and use document.location or window.locationvar url = document.createElement("a");url.href =  "https://developer.mozilla.org/en-US/search?q=URL#search-results-close-container";console.log(url.href); // https://developer.mozilla.org/en-US/search?q=URL#search-results-close-containerconsole.log(url.protocol); // https:console.log(url.host); // developer.mozilla.orgconsole.log(url.hostname); // developer.mozilla.orgconsole.log(url.port); // (blank - https assumes port 443)console.log(url.pathname); // /en-US/searchconsole.log(url.search); // ?q=URLconsole.log(url.hash); // #search-results-close-containerconsole.log(url.origin); // https://developer.mozilla.org