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 July 2015.

备注: 此特性在 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”

规范

Specification
URL
# dom-urlsearchparams-append

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
append

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

参见