1. 面向开发者的 Web 技术
  2. Web API
  3. URLSearchParams
  4. URLSearchParams：append() 方法

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

URLSearchParams：append() 方法

基线 广泛可用

自 2018年4月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

备注： 此特性在 Web Worker 中可用。

URLSearchParams 接口的 append() 方法将指定的键/值对附加为新的查询参数。

如下面的示例所示，如果同一个键被多次附加，则它将为每个值多次出现在参数字符串中。

语法

js
append(name, value)

参数

name

要附加的参数的键名。

value

要附加的参数的值。

返回值

无（undefined）。

示例

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

// 添加第二个 foo 查询参数。
params.append("foo", 4);
// 查询字符串变成：“foo=1&bar=2&foo=4”

规范

规范
URL
# dom-urlsearchparams-append

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题