在 URL 中,查询参数字符串值通常提供有关请求的信息,例如搜索参数或正在使用的对象的 ID。如果在前端处理任何业务或请求逻辑,了解如何从 URL 中检索查询字符串值非常重要。本文分享三种从 URL 获取参数的方法。

URLSearchParams

除 IE 11 之外的所有主要浏览器版本都支持该 URLSearchParams 接口。它通过解析 URL 的查询字符串并提供访问值的方法来工作。例如:

此接口的缺点之一是您必须仅将 URL 的查询字符串传递给它。如果您正在使用当前的浏览器 URL,这很容易做到,因为您只需通过 window.location.search。 如果您使用任何其他 URL,则需要单独解析并传递查询字符串。

const params = new URLSearchParams("q=devpoint&page=1");
params.get("q"); // 'devpoint'
params.get("page"); // '1'

要将查询参数解析为对象,请使用 URL.searchParams.entries()方法,该方法返回一个 Iterator key/value 对,并将Object.fromEntries其转换为对象。

const params = new URLSearchParams("q=devpoint&page=1");
const entries = params.entries();
Object.fromEntries(entries); // {q: 'devpoint', page: '1'}

以参数的方式传递数组值,参数名称可以是同一个,如下的参数 uid

const paramsString = "q=devpoint&uid=1&uid=3&uid=4";
const searchParams = new URLSearchParams(paramsString);

console.log(console.log(searchParams.getAll("uid"))); // [ '1', '3', '4' ]

URL

除了 IE 11 之外,所有主要浏览器版本也都支持 URL API。它提供了一种更灵活的 URL 解析方式,还提供了一种访问查询字符串值的方式。例如:

const url = new URL("https://stackabuse.com/search?q=devpoint&page=1");
const searchParams = url.searchParams;
searchParams.get("q"); // 'devpoint'
searchParams.get("page"); // '1'

url.searchParamsURLSearchParams 返回的实例对象类型相同。

上面的 url 对象也将 URL 的所有部分分解成各个部分。例如:

url.href; // 'https://stackabuse.com/search?q=devpoint&page=1'
url.origin; // 'https://stackabuse.com'
url.protocol; // 'https:'
url.host; // 'stackabuse.com'
url.hostname; // 'stackabuse.com'
url.port; // ''
url.pathname; // '/search'
url.search; // '?q=devpoint&page=2'
url.hash; // ''

纯JS

如果由于某种原因无法访问上述 API 或希望对解析有更多控制权,可以使用以下代码将查询字符串解析为对象。

function getQueryParams(url) {
    const paramArr = url.slice(url.indexOf("?") + 1).split("&");
    const params = {};
    paramArr.map((param) => {
        const [key, val] = param.split("=");
        params[key] = decodeURIComponent(val);
    });
    return params;
}

函数执行后的效果如下:

getQueryParams("https://stackabuse.com/search?q=devpoint&page=2"); // { q: 'devpoint', page: '2' }
Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐