location对象

253 阅读4分钟

location对象

既是 window 的属性,也是 document 的属性。window.location 和 document.location 指向同一个对象。

location.hash

哈希模式,如果没有则为空字符串 返回值:"#contents"

location.host

服务器名及端口号 返回值:"www.wrox.com:80"

location.hostname

服务器名 返回值:"www.wrox.com"

location.href

当前加载页面的完整 URL。 location 的 toString() 返回值:"www.wrox.com:80/WileyCDA/?q…"

location.pathname

URL 中的路径和(或)文件名 返回值:"/WileyCDA/"

location.port

请求的端口。如果URL中没有端口,则返回空字符串 返回值:"80"

location.protocol

页面使用的协议。通常是 "http:" 或 "https:" 返回值:"http:"

location.search

URL 的查询字符串。这个字符串以问号开头 返回值:"?q=javascript"

location.username

域名前指定的用户名 返回值:"foouser"

location.password

域名前指定的密码 返回值:"barpassword"

location.origin

URL 的源地址。只读 返回值:"www.wrox.com"

查询字符串

返回一个以每个查询参数为属性的对象

let getQueryStringArgs = function() {
// 取得没有开头问号的查询字符串
  let qs = (location.search.length > 0 ? location.search.substring(1) : ""),
    // 保存数据的对象
    args = {};
    // 把每个参数添加到 args 对象
  for (let item of qs.split("&").map(kv => kv.split("="))) {
    let name = decodeURIComponent(item[0]),
    value = decodeURIComponent(item[1]);
    if (name.length) {
      args[name] = value;
    }
  }
  return args;
}

// 假设查询字符串为?q=javascript&num=10
let args = getQueryStringArgs();
alert(args["q"]); // "javascript"
alert(args["num"]); // "10"

URLSearchParams

URLSearchParams 提供了一组标准 API 方法,通过它们可以检查和修改查询字符串。给 URLSearchParams 构造函数传入一个查询字符串,就可以创建一个实例。这个实例上暴露了 get() 、set() 和 delete() 等方法,可以对查询字符串执行相应操作。

let qs = "?q=javascript&num=10";
let searchParams = new URLSearchParams(qs);
alert(searchParams.toString()); // " q=javascript&num=10"
searchParams.has("num"); // true
searchParams.get("num"); // 10
searchParams.set("page", "3");
alert(searchParams.toString()); // " q=javascript&num=10&page=3"
searchParams.delete("q");
alert(searchParams.toString()); // " num=10&page=3"

大多数支持 URLSearchParams 的浏览器也支持将 URLSearchParams 的实例用作可迭代对象

let qs = "?q=javascript&num=10";
let searchParams = new URLSearchParams(qs);
for (let param of searchParams) {
  console.log(param);
}
// ["q", "javascript"]
// ["num", "10"]

操作地址

可以通过修改 location 对象修改浏览器的地址。首先,最常见的是使用 assign() 方法并传入一 个 URL,如下所示:

location.assign("http://www.wrox.com");

这行代码会立即启动导航到新 URL 的操作,同时在浏览器历史记录中增加一条记录。如果给 location.href 或 window.location 设置一个 URL,也会以同一个 URL 值调用 assign() 方法。比 如,下面两行代码都会执行与显式调用 assign() 一样的操作

window.location = "http://www.wrox.com";
location.href = "http://www.wrox.com";

在这 3 种修改浏览器地址的方法中,设置 location.href 是最常见的。 修改 location 对象的属性也会修改当前加载的页面。其中, hash 、 search 、 hostname 、 pathname 和 port 属性被设置为新值之后都会修改当前 URL,如下面的例子所示:

// 假设当前 URL 为 http://www.wrox.com/WileyCDA/
// 把 URL 修改为 http://www.wrox.com/WileyCDA/#section1
location.hash = "#section1";
// 把 URL 修改为 http://www.wrox.com/WileyCDA/?q=javascript
location.search = "?q=javascript";
// 把 URL 修改为 http://www.somewhere.com/WileyCDA/
location.hostname = "www.somewhere.com";
// 把 URL 修改为 http://www.somewhere.com/mydir/
location.pathname = "mydir";
// 把 URL 修改为 http://www.somewhere.com:8080/WileyCDA/
location.port = 8080;

除了 hash 之外,只要修改 location 的一个属性,就会导致页面重新加载新 URL 在以前面提到的方式修改 URL 之后,浏览器历史记录中就会增加相应的记录。当用户单击“后退” 按钮时,就会导航到前一个页面。如果不希望增加历史记录,可以使用 replace() 方法。这个方法接 收一个 URL 参数,但重新加载后不会增加历史记录。调用 replace() 之后,用户不能回到前一页。比 如下面的例子:

<!DOCTYPE html>
<html>
  <head>
    <title>You won't be able to get back here</title>
  </head>
  <body>
    <p>Enjoy this page for a second, because you won't be coming back here.</p>
    <script>
        setTimeout(() => location.replace("http://www.wrox.com/"), 1000);
    </script>
  </body>
</html>

浏览器加载这个页面 1 秒之后会重定向到 www.wrox.com。此时,“后退”按钮是禁用状态,即不能 返回这个示例页面,除非手动输入完整的 URL。 最后一个修改地址的方法是 reload() ,它能重新加载当前显示的页面。调用 reload() 而不传参 数,页面会以最有效的方式重新加载。也就是说,如果页面自上次请求以来没有修改过,浏览器可能会 从缓存中加载页面。如果想强制从服务器重新加载,可以像下面这样给 reload() 传个 true :

location.reload(); // 重新加载,可能是从缓存加载
location.reload(true); // 重新加载,从服务器加载

脚本中位于 reload() 调用之后的代码可能执行也可能不执行,这取决于网络延迟和系统资源等因 素。为此,最好把 reload() 作为最后一行代码。