URLSearchParams: append() メソッド

append()URLSearchParams インターフェイスのメソッドで、指定されたキー/値のペアを新しい検索パラメーターとして追加します。

下にある例に示すように、同じキーが複数回追加された場合、各値がパラメーター文字列に複数回現れます。

注: この機能は Web Worker 内で利用可能です

構文

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);

// 2番目の foo パラメーターを追加します。
params.append("foo", 4);
// クエリー文字列はこうなる: 'foo=1&bar=2&foo=4'

仕様書

Specification
URL Standard
# dom-urlsearchparams-append

ブラウザーの互換性

BCD tables only load in the browser

関連項目