宛墨工具函数库

Appearance

getQueryParams (获取URL中的参数) ​

getQueryParams 函数用于解析给定 URL 的查询参数，并返回一个包含参数名称及其对应值的对象。如果未提供 URL，则使用当前页面的 URL。

函数调用方式 ​

javascript
getQueryParams(url)

参数说明 ​

参数名类型描述
urlString (可选)要解析的 URL 字符串。如果未提供，则默认使用当前页面的 URL。

返回值 ​

返回一个对象，其中包含 URL 查询参数的键值对。如果某个参数有多个值，则值将是一个数组。例如：

javascript
{
    key1: 'value1',
    key2: ['value2a', 'value2b'],
    ...
}

异常处理 ​

  • 如果提供的 URL 格式不正确，将抛出 TypeError。
  • 如果 url 未提供，则使用 window.location.href，不需要处理异常。

示例代码 ​

基本用法 ​

javascript
const params = getQueryParams('https://example.com?name=John&age=30');
console.log(params); // 输出: { name: 'John', age: '30' }

处理多个相同参数 ​

javascript
const params = getQueryParams('https://example.com?name=John&name=Jane&age=30');
console.log(params); // 输出: { name: ['John', 'Jane'], age: '30' }

使用当前页面的 URL ​

javascript
// 假设当前页面的 URL 为 'https://example.com?page=1&sort=asc'
const currentParams = getQueryParams();
console.log(currentParams); // 输出: { page: '1', sort: 'asc' }

结论 ​

getQueryParams 函数提供了一种简便的方法来解析 URL 中的查询参数，返回易于使用的对象格式。该函数适用于需要处理 URL 查询字符串的场景，如数据过滤、分页、搜索等功能的实现。