当前位置：首页 > 文章列表 > 文章 > 前端 > JS获取URL哈希参数的3种方法

JS获取URL哈希参数的3种方法

2025-07-25 11:52:59 0浏览收藏

大家好，我们又见面了啊~本文《JS解析URL哈希参数的3种方法》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

解析URL哈希参数的核心在于利用window.location.hash属性获取#后的内容并处理成键值对。1. 使用原生JS字符串处理：通过substring(1)去掉#，split('&')和split('=')分割键值对，并用decodeURIComponent解码；2. 利用URLSearchParams API：创建URLSearchParams对象并遍历entries()获取键值对，更简洁现代；3. 借助第三方库如qs：调用qs.parse直接解析哈希字符串，适合复杂结构处理；此外，处理JSON结构时需用try...catch尝试JSON.parse；更新哈希不刷新页面可用window.location.hash赋值；避免错误需正确编码、格式校验、捕获异常或使用成熟库。

JS如何解析URL哈希参数 3种方法提取并处理锚点参数

URL哈希参数，也就是锚点参数，在前端开发中经常用到，用来实现页面内的导航、状态保持等功能。JS解析哈希参数的方法有很多，核心在于字符串处理。

解决方案

解析URL哈希参数的关键在于理解window.location.hash属性。这个属性返回URL中#后面的部分，包括#本身。所以，我们要做的就是提取#后面的字符串，然后解析成键值对的形式。

方法一：原生JS字符串处理

这是最基础的方法，不依赖任何库，直接使用JS的字符串处理函数。

function getHashParams() {
  let hash = window.location.hash.substring(1); // 去掉#号
  let params = {};
  if (hash) {
    hash.split('&').forEach(pair => {
      let [key, value] = pair.split('=');
      if (key) {
        params[key] = value ? decodeURIComponent(value) : true; // 处理没有值的参数
      }
    });
  }
  return params;
}

let hashParams = getHashParams();
console.log(hashParams);

这段代码首先获取window.location.hash，然后去掉#。接着，使用&分割字符串，得到键值对数组。最后，遍历数组，使用=分割键和值，并将其存储到params对象中。注意这里使用了decodeURIComponent来解码URL编码的值。

方法二：URLSearchParams API (现代浏览器)

URLSearchParams是现代浏览器提供的API，可以更方便地处理URL参数，包括哈希参数。

function getHashParams() {
  let hash = window.location.hash.substring(1);
  let params = {};
  if (hash) {
    let searchParams = new URLSearchParams(hash);
    for (let [key, value] of searchParams.entries()) {
      params[key] = value;
    }
  }
  return params;
}

let hashParams = getHashParams();
console.log(hashParams);

这种方法创建了一个URLSearchParams对象，然后使用entries()方法遍历所有的键值对。这种方法更简洁，也更符合现代JS的编程风格。

方法三：第三方库 (例如: qs)

如果你的项目已经使用了第三方库来处理URL参数，那么可以直接使用它们来解析哈希参数。以qs库为例：

import qs from 'qs';

function getHashParams() {
  let hash = window.location.hash.substring(1);
  if (hash) {
    return qs.parse(hash);
  }
  return {};
}

let hashParams = getHashParams();
console.log(hashParams);

使用第三方库的好处是代码更简洁，而且通常会处理一些边界情况，例如数组、嵌套对象等。

如何处理复杂的哈希参数结构？

如果哈希参数的值本身也是一个复杂的结构，例如JSON字符串，那么需要在解析后进行额外的处理。

function getHashParams() {
  let hash = window.location.hash.substring(1);
  let params = {};
  if (hash) {
    hash.split('&').forEach(pair => {
      let [key, value] = pair.split('=');
      if (key) {
        try {
          params[key] = JSON.parse(decodeURIComponent(value)); // 尝试解析JSON
        } catch (e) {
          params[key] = decodeURIComponent(value); // 如果不是JSON，则直接解码
        }
      }
    });
  }
  return params;
}

let hashParams = getHashParams();
console.log(hashParams);

这段代码尝试将哈希参数的值解析为JSON。如果解析成功，则将其作为JSON对象存储到params中；否则，直接解码URL编码的值。

哈希参数和查询参数的区别是什么？何时使用哈希参数？

哈希参数和查询参数的主要区别在于：

位置： 查询参数位于URL的?后面，哈希参数位于URL的#后面。
用途： 查询参数通常用于向服务器传递数据，例如搜索关键词、分页信息等。哈希参数通常用于前端路由、页面内导航、单页面应用的状态管理等。
服务器端： 查询参数会被发送到服务器端，服务器可以读取并处理这些参数。哈希参数不会被发送到服务器端，它们只在客户端起作用。

何时使用哈希参数？

单页面应用（SPA）： 在SPA中，哈希参数可以用来实现前端路由，模拟多页面的效果。
页面内导航： 可以使用哈希参数来实现页面内的锚点链接，方便用户快速跳转到页面的特定位置。
状态保持： 可以使用哈希参数来保持页面的状态，例如用户的选择、筛选条件等。当用户刷新页面时，可以通过读取哈希参数来恢复之前的状态。

如何更新哈希参数而不刷新页面？

可以使用window.location.hash属性来更新哈希参数，而不会导致页面刷新。

function updateHashParams(params) {
  let hash = '';
  for (let key in params) {
    if (params.hasOwnProperty(key)) {
      hash += `${key}=${encodeURIComponent(params[key])}&`;
    }
  }
  hash = hash.slice(0, -1); // 去掉最后一个&
  window.location.hash = hash;
}

updateHashParams({ page: 2, filter: 'category' });

这段代码将page和filter参数添加到URL的哈希部分，而不会刷新页面。注意这里使用了encodeURIComponent来编码URL参数的值。