URLSearchParams: toString() 方法

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有浏览器中可用。

注意:此功能在 Web Workers 中可用。

URLSearchParams 接口的 toString() 方法返回一个适合用于 URL 中的查询字符串。

注意: 此方法返回的查询字符串不包含问号。这与 Location.searchHTMLAnchorElement.searchURL.search 不同,后者都包含问号。

语法

js
toString()

参数

无。

返回值

返回一个不带问号的字符串。如果未设置任何搜索参数,则返回一个空字符串。属于 application/x-www-form-urlencoded 百分比编码集中的字符(包含除 ASCII 字母数字、*-._ 之外的所有码点)会被进行百分比编码,且 U+0020 SPACE 会被编码为 +

示例

js
const url = new URL("https://example.com?foo=1&bar=2");
const params = new URLSearchParams(url.search);

// Add a second foo parameter.
params.append("foo", 4);
console.log(params.toString()); // Prints 'foo=1&bar=2&foo=4'

规范

规范
URL
# urlsearchparams-stringification-behavior

浏览器兼容性

另见