URLSearchParams: append() 方法

Baseline 已广泛支持

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

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

URLSearchParams 接口的 append() 方法将指定的键值对作为新的搜索参数附加到 URLSearchParams 对象中。

如以下示例所示,如果多次附加相同的键,它将为每个值在参数字符串中多次出现。

语法

js
append(name, value)

参数

name

要附加的参数名称。

value

要附加的参数值。

返回值

无(undefined)。

示例

多次添加相同的参数

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);
// Query string is now: 'foo=1&bar=2&foo=4'

规范

规范
URL
# dom-urlsearchparams-append

浏览器兼容性

另见