URLSearchParams：append() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2018年4月⁩.

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

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

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

语法

append(name, value)

参数

name: 要附加的参数的键名。
value: 要附加的参数的值。

返回值

无（undefined）。

示例

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”

规范

Specification
URL # dom-urlsearchparams-append

浏览器兼容性

参见

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2024年9月23日⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content