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

瀏覽器相容性

另見